快速开始
通过统一的标准 HTTPS JSON 接口调用主流图像生成、多图编辑与音画同步视频模型。按实际用量计费($1 = 100 积分),生成结果提供 30 天有效 HTTPS 下载链接。
Base URL · https://api.callmodels.dev
接口域名与核心端点
所有请求均在服务端携带 Authorization: Bearer cm_live_... 发送至 https://api.callmodels.dev。生成的图片与视频通过 https://files.callmodels.dev 返回 30 天有效的 HTTPS 下载链接。
| 方法与路径 | 接口用途 | 计费规则 |
|---|---|---|
| GET /v1/auth/check | 验证密钥状态与可选模型白名单访问权限 | 0 积分(不计费) |
| POST /v1/images/generations | 提交文生图或 1–10 张参考图编辑任务(返回 HTTP 202) | 提交预扣,完成后实扣 |
| POST /v1/videos/generations | 提交文生视频或首尾帧图生视频任务(返回 HTTP 202) | 按秒预扣,按 0.1 秒结算 |
| GET /v1/tasks/:task_id | 查询任务状态、实扣积分与 30 天结果下载链接 | 0 积分(不计费) |
三步完成首次调用
1. 登录控制台,在 API Keys(/console/api-keys)创建服务端密钥 cm_live_...,并在 积分(/console/credits)完成充值($10 起充 = 1,000 积分)。
2. 可先调用不计费的 GET /v1/auth/check 验证鉴权,再携带 Idempotency-Key 提交任务并轮询 GET /v1/tasks/:id 获取 30 天结果下载链接。
# Step 1: Zero-cost key & model check
curl -sS "https://api.callmodels.dev/v1/auth/check?model=seedream-5.5" \
-H "Authorization: Bearer $CALLMODELS_API_KEY"
# Step 2: Submit async task (HTTP 202 Accepted)
CREATE_JSON=$(curl -sS -X POST "https://api.callmodels.dev/v1/images/generations" \
-H "Authorization: Bearer $CALLMODELS_API_KEY" \
-H "Idempotency-Key: qs_demo_20261115_01" \
-H "Content-Type: application/json" \
-d '{
"model": "seedream-5.5",
"prompt": "Minimalist glass perfume bottle on travertine stone, soft studio rim light",
"size": "16:9",
"quality": "1.5K",
"output_format": "png"
}')
TASK_ID=$(echo "$CREATE_JSON" | jq -r ".id")
# Step 3: Poll until completed or failed
while true; do
TASK_JSON=$(curl -sS "https://api.callmodels.dev/v1/tasks/$TASK_ID" \
-H "Authorization: Bearer $CALLMODELS_API_KEY")
STATUS=$(echo "$TASK_JSON" | jq -r ".status")
if [ "$STATUS" = "completed" ] || [ "$STATUS" = "failed" ]; then
echo "$TASK_JSON" | jq .
break
fi
sleep 2
done公开模型 ID 速查表
业务代码统一传入下方固定的公开 model ID。平台底层算力扩容或升级时,你的请求参数、鉴权头与返回结构保持不变。
| 公开 Model ID | 调用端点 | 计费方式与起步单价 |
|---|---|---|
| gpt-image-2.6-flare | POST /v1/images/generations | 按实际 Token · 输出 3.525 积分/千 tok(16:9 low 约 1.629 积分) |
| gpt-image-2.6-sunburst | POST /v1/images/generations | 按实际 Token · 输出 3.525 积分/千 tok(16:9 low 约 1.629 积分) |
| seedream-5.5 | POST /v1/images/generations | 固定按张 · 1K/1.5K 1.88 积分,2K 3.29 积分,参考图 +0.752/张 |
seedance-2.5-text-to-videoseedance-2.5-image-to-video | POST /v1/videos/generations | 按 0.1 秒时长 · 480p 14.061 / 720p 30.239 / 1080p 75.597 积分/秒 |
seedance-2.5-flash-text-to-videoseedance-2.5-flash-image-to-video | POST /v1/videos/generations | 按 0.1 秒时长 · 480p 14.100 / 720p 28.200 积分/秒 |
seedance-2.0-fast-text-to-videoseedance-2.0-fast-image-to-video | POST /v1/videos/generations | 按 0.1 秒时长 · 480p 5.369 / 720p 11.547 积分/秒 |
seedance-2.0-text-to-videoseedance-2.0-image-to-video | POST /v1/videos/generations | 按 0.1 秒时长 · 480p 8.838 / 720p 19.007 / 1080p 47.518 / 4K 96.938 积分/秒 |
seedance-2.0-mini-text-to-videoseedance-2.0-mini-image-to-video | POST /v1/videos/generations | 按 0.1 秒时长 · 480p 2.169 / 720p 4.665 积分/秒 |