用开放 API 生图、生视频:任务怎么提交、结果怎么取回
用开放 API 生图、生视频:任务怎么提交、结果怎么取回 关键参数
| 生图接口 | POST /v1/images/generations(同步) |
|---|---|
| 生视频流程 | 提交 → task_id → 轮询/回调 → 取回 URL |
| 回调参数 | notify_url |
| 结果形式 | 图片地址 / 视频 URL |
图像生成(同步)
文生图 / 图像编辑通常一次请求即返回结果(图片地址或 base64):
POST /v1/images/generations
{ "model": "图像模型代号", "prompt": "一只在星空下奔跑的猫", "n": 1 }
返回里会包含图片链接,可直接使用。
视频生成(异步)
视频因耗时较长,走异步任务流程:
- 提交任务,拿到 task_id。
- 轮询任务状态,或配置回调地址接收完成通知。
- 任务完成后取回视频地址。
取回结果
- 轮询:用 task_id 查询状态,状态为成功时返回视频 URL。
- 回调:在请求中填写 notify_url,完成后平台主动推送结果。
具体字段、模型代号与额度限制以官方文档为准。
常见问题
生图是同步还是异步?
文生图/图像编辑通常同步一次请求即返回图片地址或 base64,接口为 /v1/images/generations。
生视频为什么要走异步任务?
视频耗时长,先提交任务拿到 task_id,再轮询状态或用回调取回结果。
视频任务结果怎么取回?
轮询:用 task_id 查询状态,成功后返回视频 URL;回调:请求里填 notify_url,完成后平台主动推送结果。
字段与额度限制在哪确认?
具体字段、模型代号与额度限制以官方文档与控制台为准。
相关阅读
怎么让 AI 调我自己的函数 / 工具(tools 工具调用怎么写)
通过 tools 字段声明函数 schema,模型返回 tool_calls 后由你在本地执行,再把结果回传给模型继续推理。调接口怎么把图片发给 AI 看?多模态请求怎么写、图片传链接还是文件
多模态请求用 content 数组把文本与 image_url 一起传;图片可传公网可访问的链接,或传 base64 data URI,二者各有取舍。调接口报错怎么办?鉴权失败、频率超限、余额不足逐个排查
按错误类型排查:401 鉴权、403 权限、429 限频、402/余额不足、4xx 参数、5xx 服务端,本文给出逐项对策。API 密钥怎么创建?用量和额度在哪看?
在控制台「API 密钥」创建密钥;用量与额度在同页或「用量」页查看,包含调用次数、tokens 消耗与费用。相关平台
关于大模型的选型、调用与落地实践,你还可以访问以下平台:
- cloud-lab.cn —— 灵境AI 模型百科:大模型选型、对比评测与用户手册,AI Model Hub 官方知识站。
- cloud-token.ai(AI Model Hub 国内版) —— 聚合 500+ 前沿大模型,统一 OpenAI 兼容 API,免费试用、按量计费。
- cloud-ai.link(AI Model Hub 国际版) —— 面向全球用户,英文界面,统一 OpenAI 兼容 API,即开即用。