AI 图片生成与视频生成 API 汇总对比及调用指南
生图模型统一走 OpenAI Images 接口(generations / edits),视频模型统一走 /v1/videos 异步提交与轮询下载,全部与文本模型共用同一账户余额并按次计费。
多模态媒体 API 接口总览
不要把生图或视频模型发送到文本对话端点(/v1/responses、/v1/messages 或 /v1/chat/completions)。在深云 DeepClub,图片与视频均使用专用媒体接口:
| 媒体类型 | 在售代表模型 | 接入端点 | 计费方式 |
|---|---|---|---|
| 商业排版与多图参考 | gpt-image-2、gpt-image-2-adobe、gpt-image-2.5-flare、gpt-image-2.5-sunburst |
/v1/images/generations · /v1/images/edits |
按张/按次 |
| 写实光影与电商批量图 | gemini-3-pro-image、gemini-3.1-flash-image |
/v1/images/generations · /v1/images/edits |
按张/按次 |
| 插画、UI 与多视角角色一致 | nano-banana-2、nano-banana-pro |
/v1/images/generations · /v1/images/edits |
按张/按次 |
| 短视频生成与分镜预演 | Seedance-2.0-Mini、Seedance-2.0-Fast、MiniMax-H3 |
POST /v1/videos + GET /v1/videos/{task_id} |
按次(随分辨率/时长) |
1. Python OpenAI SDK 调用 AI 生图 API
import os
from openai import OpenAI
client = OpenAI(
base_url="https://deepclub.net/v1",
api_key=os.environ["DEEPCLUB_API_KEY"],
)
result = client.images.generate(
model="gpt-image-2",
prompt="极简咖啡品牌宣传海报,居中留白,高质量商业摄影质感",
size="1024x1024",
)
print(result.data[0].url or result.data[0].b64_json[:64])
横向效果对比可参见:Gemini 3 Pro Image vs GPT Image 2 生图对比。
2. AI 视频生成 API 异步三步调用流程
视频任务耗时较长,必须采用「提交任务 → 保存 task_id 轮询 → 下载 MP4」流程,避免网络超时重复提交导致重复扣费:
# 1) 提交异步任务并立即保存返回的 id
curl https://deepclub.net/v1/videos \
-H "Authorization: Bearer $DEEPCLUB_API_KEY" \
-F model=Seedance-2.0-Fast \
-F prompt="Slow dolly zoom over a misty mountain lake at sunrise" \
-F seconds=5
# 2) 轮询任务状态(queued / in_progress / completed / failed)
curl https://deepclub.net/v1/videos/$TASK_ID \
-H "Authorization: Bearer $DEEPCLUB_API_KEY"
# 3) completed 后下载视频文件
curl -o output.mp4 https://deepclub.net/v1/videos/$TASK_ID/content \
-H "Authorization: Bearer $DEEPCLUB_API_KEY"
视频参数与场景选择详见:Seedance 2.0 vs MiniMax-H3 视频 API 对比,各分辨率与秒数实时单价见 模型定价表。
常见问题
- 图片和视频生成模型支持 2K / 4K 或不同秒数吗?
- 不同模型开放的分辨率(如 1K/2K/4K)和视频时长(如 5 秒或 10 秒)规格不同,请在 /pricing 点击对应模型 ID 查看其发布的参数规格与对应单价。
- 轮询视频任务状态时超时了怎么办?
- 只要在第一步 POST /v1/videos 时持久化保存了返回的 task_id,后续通过 GET /v1/videos/{task_id} 查询与下载不会重复计费;切勿直接重试 POST 创建新任务。
- 调用生图模型时报错不支持 size 参数怎么排查?
- 请前往 /pricing 查看该图片模型当前公布支持的 size 规格列表,确保请求参数落在模型规格范围内。
更新于