Tripo3D

图像生成图像

http
Base URL: https://openapi.tripo3d.ai/v3
Endpoint: POST /generation/image-to-image
根据参考图像生成或编辑图像。支持编辑、风格迁移和多图融合。
注意
  • 此接口需要 API Key 认证。请在 Authorization 请求头中传入 Bearer {api_key}。
  • 此接口为异步 API。提交请求后，请使用 任务查询接口 轮询获取结果，或配置 Webhook 接收任务完成时的自动通知。

请求参数

请求体

modelstring默认值: seedream_v5
图像编辑模型。
  • seedream_v5 — 最强编辑、风格迁移与多图融合能力。
  • banana — 快速编辑。
  • banana_pro — 更高质量编辑。
  • banana2 — 最新快速编辑。
  • chat_image_1 — 基础图像编辑。
  • chat_image_1.5 — 更高质量编辑。
  • chat_image_2 — 最新，质量最佳编辑。
  • seedream_v5 — 最强编辑、风格迁移与多图融合能力。
inputstring必选
主要参考图像。接受公开 URL、file_token 或 task_id。
以上三种方式任选其一，不可同时传入多种类型。
  • 单张：input。多张：inputs，最多 4 张。
  • 接受：公开 URL、file_token 或图像任务输出。
说明
  • Formats: jpeg, png (recommended); webp is rejected on some provider routes
  • Max file size: 20 MB
  • Max total pixels: 6000 × 6000 = 36 MP
  • Min width/height: 14 px
  • Aspect ratio (W/H): [1/3, 3]
  • URL images must be publicly accessible. Private files require /v3/files first.
inputsstring[]
多张参考图像。每张图像的格式与 input 相同。
  • 单张：input。多张：inputs，最多 4 张。
  • 接受：公开 URL、file_token 或图像任务输出。
说明
  • 最多：4 张（seedream），10 张（banana），16 张（chat_image）
  • 引用方式：image[1]、image[2] 等。
promptstring条件必选
编辑指令。未指定模板时必填。
sizestring默认值: 2048x2048
输出图像尺寸。可传语义关键字（如 2K / 4K）或精确像素（如 2048x2048）；不同模型支持的取值不同，见下方分模型。
以下两种方式二选一，不可同时传。
  • 分辨率档位：2K / 3K。在 prompt 里描述宽高比/形状，由模型决定具体尺寸。
  • 精确像素：宽x高（默认 2048x2048）。总像素 3.69–10.40 MP，宽高比 [1:16, 16:1]。
aspect_ratiostring默认值: 1:1
输出宽高比。不传时默认 1:1（仅 banana 系列；当 size 与 aspect_ratio 均未传时由 gateway 填充）。
  • banana / banana_pro：1:1、2:3、3:2、3:4、4:3、4:5、5:4、9:16、16:9、21:9。
  • banana2 额外支持 1:8、1:4、4:1、8:1。
仅 banana 系列支持此字段；seedream / chat_image 按 size 出图，请改用 size 参数。
templatestring
编辑模板。设置后 prompt 变为可选。
  • t_pose：转换为 T-pose。
  • character_completion：补全不完整的角色。
  • 3d_enhance：增强以用于 3D 生成。
  • variants：生成设计变体。
  • figure：生成全身人物。
output_formatstring默认值: png
输出图像格式。
  • png：无损，支持透明度。
  • jpeg：文件体积更小，不支持透明度。

示例

单图示例
{
  "input": "https://example.com/reference.png",
  "prompt": "Change the silver outfit into transparent glass.",
  "model": "seedream_v5",
  "size": "2K"}
多图示例
{
  "inputs": [
    "https://example.com/photo1.png",
    "https://example.com/photo2.png"],
  "prompt": "Use character from image[1] and outfit from image[2].",
  "model": "seedream_v5"}
创建任务
{
  "code": 0,
  "data": {
    "task_id": "task_abc123"}
}
任务结果
{
  "code": 0,
  "data": {
    "task_id": "task_abc123",
    "type": "generate_image",
    "status": "success",
    "progress": 100,
    "output": {
      "generated_image": "https://cdn.tripo3d.ai/output/image.png",
      "size": "2048x2048"},
    "credits_consumed": 20,
    "created_at": "2026-04-28T12:00:00Z",
    "completed_at": "2026-04-28T12:00:08Z"}
}