Img2Vid API

Img2Vid API 用于从你自己的后端服务创建 AI 图片与视频生成任务、运行预设 app 工作流，并调用 chat 模型。媒体与 app 生成接口保持克制：查询可调用资源、上传文件、创建异步生成任务、轮询结果。

Base URL

https://img2vid.net

公开接口

Method	Endpoint	用途
GET	/api/v1/media_models	查看可用于 API 的媒体模型、公开 mode、输入和参数。
GET	/api/v1/apps	查看可调用 app 工作流及输入参数。
POST	/api/v1/files	上传图片、视频或音频素材。
POST	/api/v1/generations	创建异步媒体生成任务。
GET	/api/v1/generations/[id]	查询媒体任务状态和结果素材。
POST	/api/v1/apps/[app]/generations	创建异步 app 生成任务。
GET	/api/v1/apps/[app]/generations/[id]	查询 app 任务状态和结果素材。
GET	/api/v1/models	查询可调用 chat 模型。
POST	/api/v1/chat/completions	使用 OpenAI 兼容格式调用 chat 模型。
POST	/api/v1/messages	使用 Anthropic 兼容格式调用 chat 模型。
POST	/api/v1beta/models/{model}:generateContent	使用 Gemini 兼容格式调用 chat 模型。
POST	/api/v1beta/models/{model}:streamGenerateContent	使用 Gemini 兼容格式流式输出 chat 内容。

Chat 模型接口的详细说明见 Chat Models API。

核心工作流

1. 使用 Authorization: Bearer $BUBLE_API_KEY 鉴权。
2. 直接调用媒体模型时，从 GET /api/v1/media_models 选择 model 和 mode。
3. 调用 app 工作流时，从 GET /api/v1/apps 选择 id 和输入参数名。
4. 如果工作流需要素材输入，先上传文件。
5. 创建生成任务。
6. 轮询任务，直到状态变为 success 或 failed。

公开字段模型

Img2Vid 的公开生成接口使用扁平 JSON：素材 URL 和模型参数都直接放在请求体根层级。

字段	含义
model	稳定模型 key，例如 google/nano-banana-pro。
mode	公开操作模式，例如 text_to_image 或 frames_to_video。
prompt	生成指令。
image_urls、start_frame、end_frame、video_urls、audio_urls	媒体输入类 mode 使用的源素材 URL。
模型参数	/api/v1/media_models 返回的模型专属控制项，例如 duration、resolution、aspect_ratio、output_format。

不要传递 input、options，也不要传递 scene、sub_mode_id、provider、mediaType、media_type 等内部字段。Img2Vid 会基于 model、mode 和扁平公开输入字段在服务端自动解析内部调用链路。

App 字段模型

Apps API 同样使用扁平 JSON。先调用 GET /api/v1/apps 获取 app id 和 input_parameters，再把这些参数名直接传给 POST /api/v1/apps/{app}/generations。

App 响应不会暴露 model、provider、scene、flow、icon、tags、cover image 等内部工作流字段。