帮助/API文档
  1. (推荐)异步调用--官方格式
帮助/API文档
  • 系统使用介绍
  • API介绍
  • 项目说明
  • 导言
  • 身份验证
  • 发出请求
  • 参数详情
  • 所有对话模型均兼容 OpenAI 格式
  • OpenAI
    • 聊天(Chat)
      • 聊天完成对象
      • 聊天完成块对象
      • gpt-4-all
        • gpt-4-all(识图)
        • gpt-4-all(生成图片)
      • GPT创建聊天(补全)接口
      • 识图(gpt和gemini)
      • gpts
      • gemini-pro
    • 音频(Audio)
      • 创建语音
      • 创建转录
      • 创建翻译
    • 图像(Images)
      • README
      • 图像对象
      • 创建图像
      • 创建图片编辑
      • 创建图像变体
    • 文件(Files)
      • README
      • 文件对象
      • 上传文件
    • 自动补全(Completions)
      • 完成对象
      • 创建完成
    • 嵌入(Embeddings)
      • 嵌入对象
      • 创建嵌入
  • Google-Gemini
    • gemini官方格式
    • gemini生图(官方格式)
    • 识图(gemini)
  • Anthropic-Claude
    • 识图
    • 思考
    • 函数调用
  • 绘图接口
    • image异步格式(task)
      • 说明:接口说明及参数
      • gemini系列创建图像
      • gemini系列编辑图像
      • gpt4o创建图像
      • gpt4o编辑图像
      • 指定ID获取任务
    • Mid journey生图
      • 说明:接口说明及参数
      • 任务提交
        • 提交Describe任务(图生文)
        • 提交Imagine任务(文生图、文图生图)
        • 提交Blend任务(图生图)
        • 执行动作(所有的关联按钮动作UPSCALE; VARIATION; REROLL; ZOOM等)
        • 绘图变化(UPSCALE; VARIATION; REROLL)
        • 绘图变化-simple(UPSCALE; VARIATION; REROLL)
        • 提交Modal(提交局部重绘、ZOOM)
        • 提交Shorten任务(prompt分析)
        • MJ上传图片获得url
        • 提交图片编辑任务
        • 提交MJ视频任务
      • 任务查询
        • 指定ID获取任务
        • 根据ID列表查询任务
        • 获取任务图片的seed
      • 提交swap_face任务
    • gpt4oImage
      • image/genertions格式(dalle格式)
        • 创建图像(官方4o格式)
        • 编辑图像(官方4o格式)
      • chat格式
        • gpt-4o-image(生成图片)
        • gpt-4o-image(修改图片)
    • nano-banana
      • chat格式
        • 文生图(chat格式)
        • 图生图(chat格式)
      • image/genertions格式(dalle格式)
        • 创建图像nano-banana-2
        • 编辑图像
    • 豆包(即梦、火山)绘图
      • 快速接入说明
      • 即梦4
        • 即梦4-绘图
        • 即梦4-编辑edits
        • 即梦4-chat格式
      • 即梦3-图生图
      • 即梦3-文生图
      • AI营销商品图
      • 单图写真(pv版)
      • inpainting涂抹消除
      • inpainting涂抹编辑
      • outpainting智能扩图
      • 实时生图-图生图
    • recraftv3文生图
      • OpenAI 聊天格式
      • OpenAI Dalle3格式
    • Flux文生图
      • 官方异步格式
        • flux生成图像
        • 指定ID获取任务
      • OpenAI 聊天格式
  • 视频接口
    • openai-sora-2
      • (推荐)异步调用--官方格式
        • 提交视频生成任务
          POST
        • remix video编辑视频
          POST
        • 创建客串角色 Character
          POST
        • 提交视频生成任务(带character)
          POST
        • 指定ID获取任务
          GET
      • 异步调用--cwmp
        • 提交视频生成任务
        • remix video
        • 指定ID获取任务
      • OpenAI 聊天格式
        POST
    • google-veo
      • 异步调用
        • 提交视频生成任务
        • 提交(带图)视频生成任务
        • 指定ID获取任务
      • 异步调用--cwmp
        • 提交视频生成任务
        • 提交(带图)视频生成任务
        • 指定ID获取任务
      • OpenAI 聊天格式
    • 可灵(keling)官方格式
      • 对接教程
      • 文本生成视频
      • 图生视频
      • 指定ID获取任务
    • Vidu
      • 提交视频生成任务
      • 指定ID获取任务
    • Seedance(即梦视频)
      • 官方异步调用
        • 提交视频生成任务
        • 指定ID获取任务
    • runway
      • 官方异步调用
        • 提交视频生成任务
        • 指定ID获取任务
      • 简单格式(goamz/rocket)
        • 文本生成视频
        • 参考图片生成视频
        • video2video(视频转视频 风格重绘)
        • Act-one 表情迁移
        • 指定ID获取任务(免费)
    • luma
      • 官方异步调用
        • 提交视频生成任务
        • 指定ID获取任务
      • GoAmzAI格式
        • 提交视频生成任务
        • 指定ID获取任务
      • OpenAI 聊天格式
    • pixverse
      • 提交视频生成任务
      • 指定ID获取任务
  • 音乐接口
    • Suno
      • V1版本格式
        • 说明
        • 异步调用(API形式)格式
          • 任务提交
            • 生成歌曲
            • 生成歌词
            • 上传音乐
            • 歌曲拼接
            • 生成歌词
          • 任务查询
            • 查询任务
            • 查询歌词
        • OpenAI 聊天格式
        • GoAmzAI格式
      • 支持 newapi
        • 提示
        • suno api 说明
        • 场景1 - 灵感模式生成音乐
        • 场景2 - 自定义歌词、标题和风格
        • 场景3 - 生成纯音乐(无人声)
        • 场景4 - 灵感模式生成纯音乐
        • 场景5 - 续写/扩展已有音频
        • 场景6 - 混音重制(使用参考音频)
        • 场景7 - 替换歌曲指定片段
        • 场景8 - 全轨声曲分离
        • 场景9 - 人声分离
        • 场景10 - 改写(重新生成)
        • 场景11 - 重新填词 (Overpainting)
        • 生成歌词
        • 查询生成任务的结果
        • 上传自定义音频文件
        • 获取音乐的MIDI数据
        • 扩展Style Tags(风格标签)
    • udio(废弃)
      • 常用格式
        • 说明
        • 异步调用(API形式)格式
          • 任务提交
            • 生成歌曲
            • 续写
          • 任务查询
            • 查询任务
  • 特殊场景
    • gemini解析pdf
  • 本系统API
    • 获取用户信息(含余额)
    • 列出所有模型
  • 数据模型
    • Schemas
      • MidiComplete
      • MidiProcessing
      • ClipResult
      • Scene11_OverpaintingRequest
      • Scene10_RewriteRequest
      • Scene9_VocalStemsRequest
      • Scene8_AllStemsRequest
      • Scene7B_ReplaceGeneratedRequest
      • Scene7A_ReplaceUploadedRequest
      • Scene6B_RemixGeneratedRequest
      • Scene6A_RemixUploadedRequest
      • Scene5B_ContinueGeneratedRequest
      • Scene5A_ContinueUploadedRequest
      • Scene4_InstrumentalInspirationRequest
      • Scene3_InstrumentalCustomRequest
      • Scene2_CustomRequest
      • Error
      • Scene1_InspirationRequest
  1. (推荐)异步调用--官方格式

创建客串角色 Character

POST
/sora/v1/characters
创建角色,后续可用于 @ 调用
如果没有视频地址,可以先调用v1/upload接口进行上传
创建可被 @ 调用的角色,后续使用时注意在角色标识与 prompt 之间留一个空格。 例如:@qtpttnsu.buttonboar 在一个舞台上和 @8d4222e54.celestepaw 牵手跳 jazz 舞,舞台射灯移动照射,使用全景镜头摇镜头照射,Sony FX9 相机拍摄 35mm,电影质感。
参数说明:url、from_task 二选一,必须至少设置一个。
接口说明 — 角色客串功能: 你可以把自己生成的或上传的视频里的任意物体提取出来,作为“客串角色”加入到视频中。用户不仅能客串自身场景,也可以创建生活中的对象(如宠物、朋友)或完全虚构的角色(如怪兽、英雄、奇幻生物)。只要上传手机或相机里的视频(例如宠物鸭子的视频),或者直接生成全新角色,甚至能把日常物品(比如饼干罐)演化出有趣的面貌。任何东西都能变成客串角色,激发无限创意。
注意:这里依旧不支持上传真人视频,图像,指的是物品类对象,非真人面部;;目前可以使用真人->线稿->sora2视频->获取角色的方式使用(仿)真人出镜(后面专门写一篇(仿)真人出镜教程);若是人物面部需要走 face id 录入,目前不支持上传。

请求参数

Authorization
Header 参数

Body 参数application/json

示例
{
    "url": "https://filesystem.site/cdn/20251030/javYrU4etHVFDqg8by7mViTWHlMOZy.mp4",
    "timestamps": "1,3"
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST '/sora/v1/characters' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "url": "https://filesystem.site/cdn/20251030/javYrU4etHVFDqg8by7mViTWHlMOZy.mp4",
    "timestamps": "1,3"
}'

返回响应

🟢200成功
application/json
Body

示例
{
    "id": "ch_691ee0e4ed6c8191b7ea959e2d328e34",
    "permalink": "https://sora.chatgpt.com/profile/iitgsstkb.skywardspo",
    "profile_picture_url": "https://filesystem.site/cdn/20251120/0ee666bef7268d7380cbd902255648.jpg",
    "username": "iitgsstkb.skywardspo"
}
修改于 2025-12-04 02:01:48
上一页
remix video编辑视频
下一页
提交视频生成任务(带character)
Built with