# Eternal AI

> Eternal AI - AI Girlfriend App for Real, Intimate Relationships. The best AI girlfriend app built for real, intimate relationships. Match with AI girlfriends that feel more personal, comforting, and real.

Eternal AI is a consumer companion app where users match and chat with AI girlfriends in a vertical, TikTok-style feed of agents and short videos. The product is designed around 1:1 conversations, personalized agents, and applied visual effects, with a "2am" sub-experience for late-night intimate pairing.

The same infrastructure also powers a developer-facing Image-to-Video API. The API is intentionally minimal: one endpoint to submit a job, one endpoint to poll its status. Authentication is a bearer token; pricing is per second of output, billed in credits where 1 credit = $1. The currently supported model is `wan-ai/wan2.2-i2v-a14b-lightning`, with multiple resolutions (480p / 580p / 720p) and aspect ratios.

## IMPORTANT: read this before generating client code

Three things waste the most time when agents integrate this API on the first try. Internalize all three before writing code.

### 1. API host is NOT the docs host

- Docs live at `https://eternalai.org/api` (and `https://staging.eternalai.org/api` on staging).
- **All API requests must go to `https://open.eternalai.org`.** Example: `POST https://open.eternalai.org/api/image-to-video`.
- Do not append `/api/...` paths to the docs host. As a safety net, the docs host now 307-redirects `/api/image-to-video` and `/api/image-to-video/{id}/status` to the canonical host so guessed URLs still work — but write the right URL anyway.
- Canonical machine-readable manifest: [/api/manifest.json](/api/manifest.json) (returns base URL, endpoints, auth scheme).

### 2. Auth header is `Authorization: Bearer sk_...` — NOT `x-api-key`

- Use exactly: `Authorization: Bearer sk_<your-key>`. Keys are prefixed with `sk_`.
- The `api-key: sk_<your-key>` header is also accepted (no `x-` prefix).
- **`x-api-key` is rejected by V2 keys** with: `missing or invalid V2 API key (expected Authorization: Bearer sk_... or api-key header)`. If you see that error, fix the header name — the key itself is probably fine.
- Get a key at [/api/keys](/api/keys). API keys are server-side secrets — never expose them client-side. If you build a Next.js / Express demo, put the key in a server-side route handler and forward `Authorization` on the outbound fetch.

### 3. `duration` is a string, not a number

- Send `{"duration": "3"}`, not `{"duration": 3}`.
- A numeric value returns `{"status": false, "error": "invalid JSON body"}` even though the JSON parses fine — the failure is schema-type validation, not a parse error. If you bind a `<input type="number">` or `<select value={3}>` directly, wrap with `String(value)` before sending.
- Other fields: `cfg_scale` is a number (`0.5`), `seed` is an integer, `resolution` / `aspect_ratio` / `model_id` are strings.

### Copy-pasteable happy path

```bash
# Submit
curl -X POST https://open.eternalai.org/api/image-to-video \
  -H "Authorization: Bearer sk_<your-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A cat slowly turning its head toward the camera",
    "image_url": "https://example.com/cat-start.jpg",
    "model_id": "wan-ai/wan2.2-i2v-a14b-lightning",
    "duration": "5",
    "aspect_ratio": "16:9",
    "resolution": "720p"
  }'
# Response: { "status": true, "error": null, "result": { "request_id": "<uuid>" } }

# Poll every 2-5 seconds until result.status is "completed" or "failed".
# Typical completion: 30-90s for 720p / 5s. Set client timeout to ~5 min.
curl https://open.eternalai.org/api/image-to-video/<request_id>/status \
  -H "Authorization: Bearer sk_<your-key>"
# On failure, the reason is at result.error (string), not the envelope error.
```

## API Documentation

- [API Docs](/api/docs) - Image-to-Video API reference (auth, submit, poll, errors, billing)
- [AI Agent Integration Guide](/ai-agent-api.html) - Structured reference for AI coding agents
- [OpenAPI Specification](/.well-known/openapi.json) - Machine-readable API definition (OpenAPI 3.1)
- [API Landing](/api) - Product overview, sample prompts, sign-up
- [API Playground](/api/playground) - Try the API in-browser without writing code
- [API Pricing](/api/docs#billing) - Per-second pricing by resolution, refund policy
- [Authentication](/api/docs#auth) - Bearer-token and api-key header setup
- [Status Lifecycle](/api/docs#lifecycle) - pending -> processing -> completed/failed

## Developer Dashboard

- [API Dashboard](/api/dashboard) - Usage, balance, and recent activity
- [API Keys](/api/keys) - Create, rotate, and revoke keys
- [Top Up](/api/top-up) - Add credits to your account (1 credit = $1)
- [Usage](/api/usage) - Per-day and per-endpoint usage breakdown
- [Transactions](/api/transactions) - Credit ledger and payment history

## Platform Features

- [Home Feed](/) - Vertical, TikTok-style feed of AI girlfriends and short videos (mobile and desktop layouts)
- [Discover](/discover) - Browse AI girlfriends, creators, and effects
- [Gallery](/gallery) - Personal generation history and saved media
- [Chat](/chat) - 1:1 conversations with AI girlfriends
- [Chat Profile](/chat/profile) - Manage your in-chat identity and preferences
- [Match](/match) - Pairing flow for the "2am by Eternal AI" sub-experience
- [Profile](/profile) - Your public-facing profile and posts
- [Pricing](/pricing) - Consumer-app subscription and credit packs
- [Download](/download) - Mobile app download links

## Developer Resources

- [Quickstart (curl)](/api/docs#example) - End-to-end submit + poll example
- [Submit endpoint](/api/docs#submit) - POST /api/image-to-video field reference
- [Poll endpoint](/api/docs#poll) - GET /api/image-to-video/{request_id}/status
- [Error codes](/api/docs#submit) - 400 / 401 / 402 / 403 / 404 / 500 / 502 with messages
- [Notes and FAQ](/api/docs#notes) - Polling cadence, refunds, idempotency, output retention

## Claude Code Skill

- [Image-to-Video Skill (SKILL.md)](/skills/eternal-ai-image-to-video/SKILL.md) - Drop-in Claude Code skill: handles submit, poll, and error retries end-to-end
- [Install guide](/skills/eternal-ai-image-to-video/README.md) - One-line install for macOS / Linux / Windows
- [Use with Claude Code](/api/docs#claude-skill) - In-docs walkthrough with install commands and a sample prompt

## Supported Models

- [Image-to-Video: wan-ai/wan2.2-i2v-a14b-lightning](/api/docs#submit) - Generate a short clip from a starting still (and optional end frame). Supports 480p / 580p / 720p, aspect ratios 16:9, 9:16, 1:1, 4:3, 3:4, and durations of 1-5 seconds (default 5). The starting image (jpg/png/webp) is supplied as a public URL or base64 data URI, max 15 MB. The generated `video_url` is served from a CDN and expires about 24 hours after generation - download and re-host anything you need long-term.

## Community and Support

- [About](/about) - The team behind Eternal AI
- [Contact](/contact) - Sales and support
- [Blog](/blogs) - Product updates and technical posts
- [Affiliate Program](/affiliate) - Earn credits by referring users and developers
- [Safety](/safety) - Platform safety overview and reporting
- [Community Guidelines](/community-guidelines) - Behavior expectations for users and agents

## Legal

- [Terms of Service](/terms-of-service) - Platform terms of use
- [Privacy Policy](/privacy-policy) - Data handling and privacy practices
- [Content Policy](/content-policy) - What can and cannot be generated or hosted
- [Acceptable Use (API)](/api/legal/acceptable-use-policy) - Acceptable use for the developer API
- [API Services Agreement](/api/legal/api-services) - Developer-facing terms
- [API Privacy](/api/legal/privacy) - Privacy practices for the developer API
- [API Trust and Safety](/api/legal/trust-and-safety) - Safety stance for API outputs
- [Copyright Policy](/copyright-policy) - DMCA and copyright complaints
- [Refund Policy](/refund-policy) - Credit and subscription refund terms
- [Data Rights](/data-rights) - User data access and deletion
- [Disclaimer](/disclaimer) - General disclaimers