开始使用
该打哪条接口
基址、主机选择，以及每种请求该打哪条接口。
Modelflare 一把 Key 覆盖多套协议。每种模型的 JSON 结构并不相同。先选接口族，再从对应指南或模型页复制请求。
https://modelflare.dev/v1面向中国的 EdgeOne 流量可以使用 https://origin.modelflare.dev/v1，指向同一套应用。发送前先选好主机，不要把进行中的 POST 在主机之间重定向。
Anthropic 客户端是例外：ANTHROPIC_BASE_URL 是 https://modelflare.dev（站点 origin，不是 /v1）。官方 Claude Code CLI 会自己拼接 Messages 路径。见 Claude Code。
Authorization: Bearer YOUR_MODELFLARE_API_KEY每次请求都要带这个头，包括视频轮询和下载。在控制台创建密钥。细节见认证。
| 接口族 | 典型入口 | 适用场景 |
|---|---|---|
| Chat Completions | POST /v1/chat/completions |
OpenAI 兼容对话。第一次请求见快速开始。 |
| Responses | POST /v1/responses |
Codex 和 Grok Build。 |
| Anthropic Messages | Anthropic 兼容 Messages | Claude Code。 |
| 图片 | POST /v1/images/generations |
GPT Images、Wan Image、Seedream。完整字段见图片模型。 |
| Gemini 原生 | POST /v1beta/models/{model}:generateContent |
Gemini CLI 和 Gemini 图片模型。 |
| 视频 | POST /v1/videos |
Seedance、Wan、Kling 等异步视频模型。轮询 GET /v1/videos/{task_id}，下载 GET /v1/videos/{task_id}/content。完整结构见视频模型。 |
| 模型列表 | GET /v1/models |
列出当前 Key 能调用的模型。 |
发到错误入口的图片和视频请求会返回 unsupported_endpoint。不要把 Gemini 图片字段发到 /v1/images/*，也不要把 GPT Images 字段发到 generateContent。不要把 Chat Completions 字段混进 Responses 或 Anthropic 客户端。
图片和视频请使用 media 分组的 API Key。结果地址可能过期，视频任务成功后应及时转存。
列出当前 Key 可用的模型
Section titled “列出当前 Key 可用的模型”GET
https://modelflare.dev/v1/modelscurl https://modelflare.dev/v1/models \ -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY"响应列出当前 Key 能调用的模型。它不能替代公开的模型与价格页，后者还包含价格、分组和协议标记。JSON 的 model 字段必须使用精确 id。见模型与分组。