生图与视频
生成和编辑图片,以及异步生成视频。
普通的文本分组不能生图,会返回 Image generation is not enabled for this group。先创建一把绑定支持生图或视频的分组的密钥:控制台分组下拉框里的说明会写明这个分组能不能生图、生视频,以及每张、每秒的价格。
| 用途 | 模型系列 |
|---|---|
| 生图、改图 | gpt-image-* |
| 生图 | grok-imagine-image* |
| 生成视频 | grok-imagine-video* |
具体的模型名用 /v1/models 查,下面示例里的要换成你的。
生成图片
curl https://otokapi.com/v1/images/generations \
-H "Authorization: Bearer sk-你的密钥" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2",
"prompt": "一只骑自行车的鹈鹕",
"size": "1024x1024"
}'用 OpenAI SDK 也可以:
from openai import OpenAI
client = OpenAI(
base_url="https://otokapi.com/v1",
api_key="sk-你的密钥",
)
result = client.images.generate(
model="gpt-image-2",
prompt="一只骑自行车的鹈鹕",
size="1024x1024",
)编辑图片
curl https://otokapi.com/v1/images/edits \
-H "Authorization: Bearer sk-你的密钥" \
-F model="gpt-image-2" \
-F image="@input.png" \
-F prompt="把背景换成海边"异步生图
生成时间较长时,建议用异步接口,避免连接超时。在路径后面加 /async,提交后立即返回任务:
curl https://otokapi.com/v1/images/generations/async \
-H "Authorization: Bearer sk-你的密钥" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2",
"prompt": "一只骑自行车的鹈鹕"
}'接口返回 202,内容里有 task_id、status 和 poll_url。然后用 poll_url 查询结果:
curl https://otokapi.com/v1/images/tasks/任务ID \
-H "Authorization: Bearer sk-你的密钥"改图同样可以用 POST /v1/images/edits/async。
生成视频
视频是异步生成的:先提交任务,再查询进度,完成后下载。
curl https://otokapi.com/v1/videos/generations \
-H "Authorization: Bearer sk-你的密钥" \
-H "Content-Type: application/json" \
-d '{
"model": "grok-imagine-video",
"prompt": "一只骑自行车的鹈鹕"
}'用返回的 request_id 查询进度和获取内容:
| 用途 | 路径 |
|---|---|
| 查询进度 | GET /v1/videos/{request_id} |
| 获取视频 | GET /v1/videos/{request_id}/content |
视频按秒计费,生成前先确认时长。