接入文档

五分钟接入晟域API

使用标准 HTTP 请求调用图片与视频模型。所有请求均使用 Bearer API 密钥鉴权。

1准备 API 密钥

登录控制台，进入“API 密钥”页面并创建密钥。密钥以 sy- 开头。

密钥只在创建时完整显示一次，请妥善保存。

2查看可用模型

curl "https://api.chengyuapi.top/v1/models" \
  -H "Authorization: Bearer sy-你的密钥"

3创建图片任务

curl -X POST "https://api.chengyuapi.top/v1/images" \
  -H "Authorization: Bearer sy-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "你在晟域后台添加的图片模型名称",
    "prompt": "电影感城市夜景，雨后街道",
    "size": "1024x1024",
    "images": [],
    "extra": {}
  }'

4创建视频任务

curl -X POST "https://api.chengyuapi.top/v1/videos" \
  -H "Authorization: Bearer sy-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "你在晟域后台添加的视频模型名称",
    "prompt": "镜头缓慢推进，人物望向远方",
    "seconds": 10,
    "size": "9:16",
    "images": [],
    "extra": {}
  }'

5查询任务结果

创建任务后会返回 task_id，使用它查询状态。

curl "https://api.chengyuapi.top/v1/videos/sy_video_xxx" \
  -H "Authorization: Bearer sy-你的密钥"

queued 排队in_progress 生成中completed 完成failed 失败并退款