跳到正文
OpenToken 文档

生图与视频

生成和编辑图片,以及异步生成视频。

普通的文本分组不能生图,会返回 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

视频按秒计费,生成前先确认时长。

本页内容