Get started
Models
Every model ID you can call, and how to choose between them.
Pass one of the model IDs below in the model field of your request. New models land as they ship, and live pricing for each is in the dashboard.
Choosing a model
- Claude models (
claude-*) are best used with Claude Code. For direct requests, call them through Chat Completions; the Messages API currently serves Claude Code. - GPT models (
gpt-*) work with any OpenAI-compatible client: the Chat Completions and Responses APIs, the OpenAI SDK, Codex CLI, chat apps and coding agents. - Open-weight models work through Chat Completions, for direct requests and agent frameworks.
deepseek-v4.1-flash-1017also runs in Claude Code.
For an agent framework, use an open-weight or GPT model. See the model support matrix.
Claude models
Call these from Claude Code, or through /v1/chat/completions for direct requests.
All text models support tool use. See Tool use and Reasoning.
GPT models
Call these through the OpenAI-compatible /v1/chat/completions or /v1/responses endpoints.
GPT models support tool calling and reasoning. See GPT (OpenAI-compatible) to connect the OpenAI SDK, Cursor, or curl.
Open-weight models
Call these through the OpenAI-compatible /v1/chat/completions endpoint. deepseek-v4.1-flash-1017 also runs in Claude Code, over /v1/messages; the others aren't reachable through /v1/messages, and none through /v1/responses. They are the recommended choice for opencode.
Image models
Call these through /v1/images/generations and /v1/images/edits.
Every image model supports text-to-image and all ten aspect ratios. Sizes are per model: nano-banana-2.1 renders at 1K, 2K or 4K, the others at 1K or 2K.
Every image model also edits. /v1/images/edits takes reference images on all four, up to the limit in the table above; sending more returns 400. Use them for edits, multi-image blends and subject consistency, and cite each in the prompt as @image1, @image2, and so on. See the Seedream guide.
Video models
Call these through the async /v1/videos endpoint.
Durations are per model: a value one model accepts, another rejects. Every clip from every video model includes synchronized audio.
Every video model takes references. How many input_reference files you send picks the mode:
- None: text-to-video from the prompt alone.
- One: animates that image as the first frame.
- Two or more: uses them as subject and style references rather than frames, up to 30 on
seedance-2.5, 9 onseedance-2.0, 20 onwan-3.0and 10 ongemini-omni-1.1-flash. Cite them in the prompt as@image1,@image2, and so on.
All four also accept an optional last frame alongside exactly one input_reference, for first plus last frame animation. See Videos.
seedance-2.5 renders at 480p, 720p or 1080p in six aspect ratios (16:9, 9:16, 4:3, 3:4, 1:1, 21:9; every size is under Sizes), and generates synchronized audio at no extra cost. Clips run up to 30 seconds, and price scales with both duration and resolution. A single starting frame is cover-cropped to the size you order. It also makes quick 480p drafts you can finish in 1080p: see Drafts.
seedance-2.0 takes the same sizes as seedance-2.5 at a lower price, with clips up to 15 seconds and synchronized audio at no extra cost. A single starting frame is cover-cropped to the size you order.
wan-3.0 renders at 480p, 720p or 1080p in 16:9, 9:16, 4:3, 3:4 or 1:1, every ratio of a resolution at one price, with clips up to 30 seconds. With a single starting frame there is no aspect setting: the clip takes its shape from the frame, and the size only picks the resolution tier.
gemini-omni-1.1-flash renders at 720p, landscape (1280x720) or portrait (720x1280), with clips up to 10 seconds. Like seedance-2.5, it cover-crops a single starting frame to the size you order.
A prompt is required in every mode. When you supply a starting frame it should describe the motion, not the scene: the scene is already the frame you uploaded.
Deprecated models
These models are still served until the date below, then removed. After that, a request to one is rejected and the error names its replacement. Sizes and durations differ between a model and its replacement, so check the tables above when you switch.
GET /v1/models marks each one with "deprecated": true, plus its "replacement" and "retires_on" date, so you can check for them in code. Every response for one of these models also carries the standard Deprecation and Sunset headers, a Link to this section, and x-roteo-model-replacement with the model to move to.
Pricing
Live per-token and per-image prices for every model are on the pricing page.
Listing models in code
Call GET /v1/models (no key needed) for the OpenAI-style JSON list (?type=video adds each video model's sizes, ratios, reference limits and the price of every size and duration), or point an agent at /v1/llms.txt for the live models and endpoints in plain text.