该打哪条接口

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

每次请求都要带这个头，包括视频轮询和下载。在控制台创建密钥。细节见认证。

接口族

一把 Modelflare API Keyhttps://modelflare.dev

Chat Completions

POST /v1/chat/completions

OpenAI 兼容对话。

Responses

POST /v1/responses

Codex 和 Grok Build。

Anthropic Messages

ANTHROPIC_BASE_URL=https://modelflare.dev

官方 Claude Code CLI 会自己拼接 Messages 路径。

Images

POST /v1/images/generations

GPT Images、Wan Image 和 Seedream。

Gemini 原生

POST /v1/models/{model}:generateContent

Gemini 图片模型。Gemini CLI 会自己使用 /v1beta 写法。

Video

POST /v1/videos

创建任务：先轮询，再下载结果。

Seedance 素材

POST /volc/asset/*

管理 Seedance 素材组和服务方媒体 ID。

Models

GET /v1/models

当前 Key 能调用哪些模型。

一把 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 /v1/models/{model}:generateContent`	Gemini 图片模型；国内入口 `origin.modelflare.dev` 同样可用。Gemini CLI 会自己在 `/v1beta` 下拼出同一路径，这个写法只有 `modelflare.dev` 提供。
视频	`POST /v1/videos`	Seedance、Wan、Kling 等异步视频模型。轮询 `GET /v1/videos/{task_id}`，下载 `GET /v1/videos/{task_id}/content`。完整结构见视频模型。
Seedance 素材	`POST /volc/asset/*`	创建、查询、更新和删除服务方素材组与媒体素材。见Seedance 素材管理。
模型列表	`GET /v1/models`	列出当前 Key 能调用的模型。

发到错误入口的图片和视频请求会返回 unsupported_endpoint。不要把 Gemini 图片字段发到 /v1/images/*，也不要把 GPT Images 字段发到 generateContent。不要把 Chat Completions 字段混进 Responses 或 Anthropic 客户端。

图片和视频可以使用智能 API Key，也可以使用 media 分组的 API Key。结果地址可能过期，视频任务成功后应及时转存。

Seedance 素材管理同样可以使用智能 API Key 或 media 分组 API Key。素材创建是异步的；使用 GetAsset 轮询到 Active 后，再把返回的 asset://<ID> 原样放入支持的 Seedance 请求。网关按用户隔离素材归属，资源管理操作不额外扣用户额度。

列出当前 Key 可用的模型

GEThttps://modelflare.dev/v1/models

curl https://modelflare.dev/v1/models \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY"

响应列出当前 Key 能调用的模型。它不能替代公开的模型与价格页，后者还包含价格、分组和协议标记。JSON 的 model 字段必须使用精确 id。见模型与分组。