API Docs
  1. 官方格式
API Docs
  • 指南
  • 获取 Base URL 和 API Key
  • 通知设置-WebHook参数介绍
  • 配置方式
  • 列出模型
    • Models(列出模型)
      GET
  • 聊天(Chat)
    • 所有对话模型均兼容 OpenAI 格式
    • Realtime (实时语音、对话
    • 聊天完成对象
    • 聊天完成块对象
    • 视觉语言模型介绍
    • Claude 官方格式
      • Messages(官方Anthropic格式)
      • Messages(识图)
      • Messages(思考)
      • Messages(函数调用)
    • GPTs
      • 简介
      • 通过关键词搜索 GPTs
      • 通过ID搜索 GPTs
      • 通过关键词搜索 GPTs V2
      • 通过ID搜索 GPTs V2
    • Chat(聊天)
      POST
    • Chat(流式返回)
      POST
    • Chat(分析图片)
      POST
    • Chat(结构化输出)
      POST
    • Chat(工具tools调用)
      POST
    • Chat(指定GPTs)
      POST
    • Chat(修改图片)
      POST
    • Chat(生成图片)
      POST
    • Chat(分析视频)
      POST
    • Chat(Claude Thinking)
      POST
    • gpt-3.5-turbo-instruct
      POST
  • RAG(嵌入、重排序
    • 嵌入(Embeddings)
      • 嵌入对象
      • 多模态向量嵌入
      • 创建嵌入
    • 重排序(Reranker)
      • 介绍
      • rerank
  • 视频模型
    • 视频生成模型简介
    • pixverse
      • 通用版
        • 接入文档
        • 生成任务
        • 查询任务(免费
        • 创建角色
      • 简单版
        • 接入文档
        • Generate(图生视频
        • Generate(文生视频
        • 获取进度(免费
    • 快手可灵(官方格式)
      • 对接教程
      • Callback协议
      • 绘图、虚拟试穿请看绘图模型-可灵
      • 文生视频
      • 图生视频
      • 视频延长
      • 对口型
      • 视频特效
      • 查询任务(免费
    • Luma 文生视频
      • 官方接口格式
        • 任务查询
          • 查询单个任务(免费
          • 批量获取任务(免费
        • 提交生成视频任务
        • 扩展视频
        • 提交生成视频任务-异步
        • 获取视频无水印链接(VIP版才支持)(废弃,查询接口有返回
      • GoAmzAI格式(兼容版,开发接入请勿对接
        • 生成视频 (兼容版,开发接入请勿对接
        • 获取视频(免费
    • 智谱清影 文生视频
      • 生成(generations)
      • 查询(async-result)(免费
      • 查询(async-result) 批量(免费
    • Runway
      • 官方格式
        • 接入介绍
        • 提交视频生成任务
          POST
        • 查询视频任务(免费
          GET
      • 简单版(goamz/rocket
        • style 列表
        • generate(文生视频
        • generate(参考图片)
        • 查询视频任务(免费
        • video2video(视频转视频 风格重绘
        • Act-one 表情迁移
    • Viggle 舞蹈合成
      • 介绍
      • Pro 无水印
        • 上传舞蹈视频
        • 创建舞蹈视频任务
        • 上传角色图片
        • 获取任务进度、结果(免费
        • 获取官方舞蹈视频模版-获取tag
        • 获取官方舞蹈视频模版-获取tag下的模版
      • 普通版 有水印
        • 上传舞蹈视频
        • 创建舞蹈视频任务
        • 上传角色图片
        • 获取任务进度、结果
        • 获取官方舞蹈视频模版-获取tag
        • 获取官方舞蹈视频模版-获取tag下的模版
    • Pika
      • 通用版
        • 接入介绍
        • generate (文生视频\图生视频\视频生视频)
        • 获取pika affect列表(免费
        • 查询视频任务(免费
  • 数字人
    • 简介
    • 生成数字人视频
    • 获取任务详情(免费
    • 查询默认 voice 列表(免费
  • 绘图模型
    • 生图模型简介
    • OpenAI Dall-e 格式
      • Flux
      • Recraftv3
      • 生图
      • 图像编辑(gpt-image-1)
    • OpenAI 聊天格式
      • Chat(兼容Flux)
      • Chat(兼容Recraftv3)
      • Chat(兼容Dalle3\Dalle2)
    • Mid journey 文生图
      • Midjourney接入向导
      • 补充 其他参数以及回调
      • 换脸任务提交
        • 提交swap_face任务
      • 任务提交
        • 绘图变化(UPSCALE; VARIATION; REROLL)
        • 执行动作(所有的关联按钮动作UPSCALE; VARIATION; REROLL; ZOOM等)
        • 绘图变化-simple(UPSCALE; VARIATION; REROLL)
        • 提交Blend任务(图生图)
        • 提交Describe任务(图生文)
        • 提交Imagine任务(文生图、文图生图)
        • 提交Modal(提交局部重绘、ZOOM)
        • 提交Shorten任务(prompt分析)
      • 任务查询(免费
        • 根据ID列表查询任务(免费
        • 指定ID获取任务(免费
        • 获取任务图片的seed(免费
    • Flux 文生图
      • Openai Dalle3 格式
      • Replicate 格式
      • Openai Chat 格式
    • Ideogram(官方格式
      • Generate 3.0(文生图)
      • Edit 3.0(编辑)
      • Remix 3.0(混合图)
      • Reframe 3.0(重构)
      • Replace Background 3.0(背景替换)
      • ideogram(文生图)
      • Remix(混合图)
      • Upscale(放大高清)
      • Describe(描述)
      • Edit(编辑)
    • recraft 官方格式
      • 附录
      • Generate Image(生成图片)
      • Vectorize Image(矢量化图片)
      • Remove Background(删除背景)
      • Clarity Upscale(清晰度提升)
      • Generative Upscale(生成高清)
      • Create style(创建样式)
    • 快手可灵(官方格式)
      • Callback协议
      • 简介
      • 视频、对口型请看视频模型-可灵
      • 虚拟试穿
      • 图像生成
      • 查询任务(免费
    • SeedEdit(图片编辑
      • Dall-e 格式
      • OpenAI 聊天格式
    • Replicate
      • 接入教程
      • 获取任务进度(predictions (免费
      • 创建任务-通过模型version(predictions)
      • 创建任务-通过url路径
      • 创建任务-stability-ai/stable-diffusion
      • 创建任务-stability-ai/sdxl
      • 创建任务-stability-ai/stable-diffusion-inpainting
      • 创建任务-stability-ai/stable-diffusion-img2img
      • 创建任务-lucataco/flux-schnell-lora
      • 创建任务-lucataco/flux-dev-lora
      • 创建任务-andreasjansson/stable-diffusion-animation
      • 创建任务-lucataco/animate-diff
      • 创建任务-sujaykhandekar/object-removal
      • 创建任务-cjwbw/rembg
      • 创建任务-black-forest-labs/flux-1.1-pro
      • 创建任务-black-forest-labs/flux-1.1-pro-ultra
      • 创建任务-black-forest-labs/flux-dev
      • 创建任务-black-forest-labs/flux-pro
      • 创建任务-black-forest-labs/flux-schnell
      • 创建任务-minimax/video-01-live
      • 创建任务-minimax/video-01
      • 创建任务-recraft-ai/recraft-v3
      • 创建任务-recraft-ai/recraft-v3-svg
      • 创建任务-ideogram-ai/ideogram-v2-turbo
    • 豆包智能绘图
      • 能力介绍&计费说明
      • 同步请求例子: SeedEdit
      • 异步请求提交例子: SeedEdit
      • 异步请求查询例子: SeedEdit
      • 即梦3.0
      • 通用2.1-文生图
      • 通用2.0Pro-指令编辑(SeedEdit)
      • 通用2.0Pro-文生图
      • 通用2.0-角色特征保持
      • 通用2.0-文生图
      • 通用2.0Pro-图生图
      • 通用1.4-角色特征保持
      • 通用1.4-文生图
      • 动漫1.3.X-文生图/图生图
      • 通用XL pro-图生图
      • 通用XL pro-文生图
      • AI营销商品图
      • 单图写真(pv版
      • inpainting涂抹消除
      • inpainting涂抹编辑
      • outpainting智能扩图
      • 实时生图-图生图
  • 音频接口
    • Suno文生歌
      • 设置 suno 版本
      • 常用格式
        • 补充
        • 场景应用
        • 任务提交
          • 音乐生成参数介绍
          • 生成歌曲(灵感模式)
          • 生成歌曲(自定义模式)
          • 生成歌曲(续写模式)
          • 生成歌词
          • 上传音乐
          • 歌曲拼接
        • 任务查询(免费
          • 批量获取任务
          • 查询单个任务
      • V1
        • 生成歌曲(灵感模式)
        • 生成歌曲(自定义模式)
        • 生成歌曲(续写模式)
        • 查询
        • 生成歌词
        • 查询歌词
        • 生成歌曲(拼接歌曲)
    • OpenAI(TTS\Wishper
      • 创建语音(tts
      • 创建转录(whisper
      • 创建翻译(whisper
  • 文件上传(Files)
    • README
    • 文件对象
    • 上传文件
  • PPT接口
    • 文多多(官方格式)
      • 介绍
      • 分页查询 PPT 模板(免费
      • 更换 PPT 模板(免费
      • 修改大纲(免费
      • 解析文件内容(免费
      • 生成大纲(免费
      • 生成大纲内容(免费
      • 随机 PPT 模板(免费
      • 获取 PPT 列表(免费
      • 加载 PPT 数据(免费
      • 下载 PPT(免费
      • 更新 PPT 属性(免费
      • 保存 PPT(免费
      • 删除PPT(免费
      • 生成大纲内容同时异步生成PPT(免费
      • 查询异步生成PPT信息(免费
      • ppt转json(免费
      • json转ppt
  • 帮助中心
    • 常见问题及解决办法
  • 平台API
    • 获取用户信息(余额
  • 废弃、未开放
    • Vidu(官方格式)
      • 普通
        • 创建视频(tasks)
        • 高清视频(tasks)
        • 视频状态(state)
        • 视频查询(tasks-get)
    • Udio文生歌
      • 接入流程
      • 根据描述创建音乐
      • 根据歌词创建音乐
      • 音乐续写
      • 获取任务进度(免费
    • Sora
      • 创建视频
      • 查询视频任务(免费
  1. 官方格式

接入介绍

API 参考

开始生成

从图像生成视频

POST /v1/image_to_video
该端点将启动一项新任务,根据图像提示生成视频。

Authorization

将 HTTP Authorization 标头与Bearer方案以及 API 密钥一起使用。

Headers

X-Runway-Version 需的
必须将此字段设置为精确的值 2024-11-06

请求正文Request body

promptImage
必需的
PromptImages 的字符串或数组(对象)
字符串 < uri >
包含要用作生成视频第一帧的编码图像的 HTTPS URL 或数据 URI。有关更多信息,请参阅我们的图像输入文档。

对象数组
表示要在输出视频中使用的图像的对象数组。任何两个提供的图像都不能具有相同的position值。

uri
必需的
string
< URI >
包含编码图像的 HTTPS URL 或数据 URI。有关更多信息,请参阅有关图像输入的文档。

position
必需的
string
接受的值:
“第一的”
“最后的”
输出视频中图像的位置。“first”将使用图像作为视频的第一帧,“last”将使用图像作为视频的最后一帧。

model
必需的
string
接受的值:
“gen3a_turbo”
要使用的模型变体。

seed
整数
[0...4294967295]
如果未指定,则选择随机数。改变种子整数是一种针对相同其他请求参数获得不同结果的方法。对相同请求使用相同的种子整数将产生类似的结果。

promptText
string
<= 512 个字符
长度最多为 512 个 UTF-16 代码点的非空字符串(即promptText.length === 512JavaScript 中的字符串)。这应该详细描述输出中应出现的内容。

watermark
布尔值
默认:
错误的
一个布尔值,指示输出视频是否包含 Runway 水印。

duration
整数
默认:
10
接受的值:
5
10
输出视频的持续秒数。

ratio
string
接受的值:
“1280:768”
“768:1280”
输出视频的分辨率。

响应
200
任务已成功创建。

响应架构:application/json
id
必需的
string
<唯一标识号>
新创建任务的ID。使用此ID可以查询任务状态并检索生成的视频。

429
您已超出此端点的速率限制。

获取任务详细信息

GET /v1/tasks/{id}
返回有关任务的详细信息。此 API 的使用者不应期望给定任务的更新频率高于每五秒一次。

验证
Authorization
将 HTTPAuthorization标头与Bearer方案以及 API 密钥一起使用。

路径参数
id
必需的
string
<唯一标识号>
之前已提交且还未被取消或删除的任务的ID。

标头
X-Runway-Version
必需的
string
必须将此字段设置为精确的值2024-11-06。

响应
200
任务状态。

响应架构:application/json

id
string
<唯一标识号>
正在返回的任务的 ID。

status

"RUNNING"
"SUCCEEDED"
"FAILED"
"PENDING"
"CANCELLED"
"THROTTLED"

PENDING tasks have been enqueued and are waiting to run.
THROTTLED tasks are waiting to be enqueued until other jobs have finished running.
RUNNING tasks are currently being processed.
SUCCEEDED tasks have completed successfully.
FAILED tasks have failed.
CANCELLED tasks have been aborted.

createdAt
string
<日期时间>
提交任务的时间戳。

failure
string
如果状态为FAILED,这将包含一个人性化的失败原因。

failureCode
string
如果任务的状态为FAILED,则包含机器可读的错误代码。这是一个以点分隔的字符串,最左边的部分是最通用的,最右边的部分是最具体的。例如,SAFETY.INPUT.TEXT表示由于输入文本的内容审核错误,任务失败。

output
数组
字符串
< URI >
[ 项目< uri > ]
如果状态为SUCCEEDED,则将包含一个字符串数组。每个字符串都是一个返回任务输出的 URL。URL 将在 24-48 小时内过期;再次获取任务以获取新的 URL。希望您下载这些 URL 上的资产并将其存储在您自己的存储系统中。

progress
数字
如果任务的状态为RUNNING,它将包含一个介于 0 和 1 之间的浮点数,表示生成的进度。

404
该任务不存在、已被删除或取消。

修改于 2024-11-15 03:51:32
上一页
查询(async-result) 批量(免费
下一页
提交视频生成任务
Built with