{
  "openapi": "3.0.3",
  "info": {
    "title": "看海无限画布 API",
    "version": "2026.10.19",
    "description": "本站视频API。Base URL为https://yioapp.top/openapi/v1。使用本站完整Bearer密钥；按本站id查询，每60秒一次，终态停止轮询。H3显示名MiniMaxH3 2K满血版，实际参数768p、5–15秒、1–8图、最多3音频、不支持参考视频。H3完成后video_url为签名链接，保留exp和sig，可直接播放；本站查询及content接口仍需认证。价格和可用状态以本人密钥GET /models为准。",
    "x-updated-at": "2026-10-19"
  },
  "servers": [
    {
      "url": "https://yioapp.top/openapi/v1"
    }
  ],
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "paths": {
    "/models": {
      "get": {
        "summary": "读取模型和价格",
        "operationId": "listModels",
        "responses": {
          "200": {
            "description": "模型列表"
          }
        }
      }
    },
    "/account": {
      "get": {
        "summary": "读取账号积分余额",
        "operationId": "getAccount",
        "responses": {
          "200": {
            "description": "账号信息"
          }
        }
      }
    },
    "/videos": {
      "post": {
        "summary": "创建视频生成任务",
        "operationId": "createVideo",
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": false,
            "schema": {
              "type": "string",
              "minLength": 8,
              "maxLength": 100
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/VideoCreateRequest"
              }
            }
          }
        },
        "responses": {
          "202": {
            "description": "任务已创建"
          },
          "400": {
            "description": "参数错误"
          },
          "402": {
            "description": "积分不足"
          },
          "503": {
            "description": "模型暂不可用"
          },
          "429": {
            "description": "单用户滚动60秒最多提交100条任务。"
          }
        }
      }
    },
    "/videos/{id}": {
      "get": {
        "summary": "查询视频任务",
        "operationId": "getVideo",
        "parameters": [
          {
            "$ref": "#/components/parameters/TaskId"
          }
        ],
        "responses": {
          "200": {
            "description": "任务状态",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VideoTask"
                }
              }
            }
          }
        },
        "description": "使用创建时本站id查询，状态queued/running/completed/failed。通常60秒查询一次，终态停止。主动查询可获取最新结果URL；播放失败时获取最新video_url，保留所有签名参数。"
      }
    },
    "/videos/{id}/content": {
      "get": {
        "summary": "读取或下载视频内容",
        "operationId": "getVideoContent",
        "parameters": [
          {
            "$ref": "#/components/parameters/TaskId"
          },
          {
            "name": "Range",
            "in": "header",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "按上游能力处理，例如bytes=0-1023；不保证206。"
          }
        ],
        "responses": {
          "200": {
            "description": "视频文件"
          },
          "206": {
            "description": "视频分段"
          },
          "307": {
            "description": "跳转到结果完整URL。"
          },
          "401": {
            "description": "本站未认证"
          },
          "404": {
            "description": "任务不存在或不属于当前用户"
          },
          "409": {
            "description": "视频未完成或不可用"
          }
        },
        "description": "本站内容接口需要Bearer认证；可能200视频流、支持时206、或307跳转。不保证所有渠道支持Range。自动跳转不可向其他域名泄露本站密钥。"
      }
    },
    "/files": {
      "post": {
        "summary": "上传真实图片或复用本人本站素材",
        "operationId": "uploadFile",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "image_b64": {
                    "type": "string",
                    "description": "完整data URI或真实图片纯Base64；兼容本站素材URL。"
                  },
                  "image_url": {
                    "type": "string",
                    "description": "本人已上传的本站素材URL；不支持任意外部URL抓取。"
                  }
                },
                "anyOf": [
                  {
                    "required": [
                      "image_b64"
                    ]
                  },
                  {
                    "required": [
                      "image_url"
                    ]
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "素材已保存"
          },
          "400": {
            "description": "空或无效图片；EMPTY_REFERENCE_ASSET表示内容为空。"
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "koko_live_..."
      }
    },
    "parameters": {
      "TaskId": {
        "name": "id",
        "in": "path",
        "required": true,
        "schema": {
          "type": "string"
        }
      }
    },
    "schemas": {
      "VideoCreateRequest": {
        "type": "object",
        "required": [
          "model",
          "prompt"
        ],
        "properties": {
          "model": {
            "type": "string",
            "description": "本站模型ID。使用GET /models实时目录并检查enabled/maintenance；不能用上游模型名。",
            "example": "minimaxh3"
          },
          "prompt": {
            "type": "string",
            "minLength": 1
          },
          "duration": {
            "type": "integer",
            "description": "秒数，按模型目录；minimaxh3为5–15，chaomeng为15或30，其他以目录为准。"
          },
          "seconds": {
            "type": "integer",
            "description": "duration兼容字段，单位秒。"
          },
          "aspect_ratio": {
            "type": "string",
            "example": "16:9"
          },
          "ratio": {
            "type": "string",
            "example": "16:9"
          },
          "resolution": {
            "type": "string",
            "example": "720p",
            "description": "实际分辨率参数；minimaxh3仅768p，显示名称中的2K不改变请求参数。"
          },
          "mode": {
            "type": "string",
            "example": "text-to-video"
          },
          "attachments": {
            "type": "array",
            "items": {
              "type": "object"
            }
          },
          "reference_images": {
            "type": "array",
            "items": {
              "type": "object"
            },
            "description": "含url的参考图对象数组，不接受空文件。"
          },
          "image_urls": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "真实非空图片公网URL；H3需1–8张，超梦最多9张。上传返回相对URL需补全本站域名，保留token。"
          },
          "reference_videos": {
            "type": "array",
            "items": {
              "type": "object"
            },
            "description": "含url的对象数组，仅支持视频参考的模型可用；H3、超梦和lingjing-sd2.5不支持。"
          },
          "video_urls": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "真实视频公网URL数组，按模型能力；H3和超梦不支持。"
          },
          "reference_audios": {
            "type": "array",
            "items": {
              "type": "object"
            }
          },
          "audio_urls": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "真实音频公网URL；H3最多3个，超梦不支持。"
          },
          "image_ids": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "POST /files返回的本站图片ID。"
          }
        },
        "description": "创建请求示例中的占位素材不能原样提交。按模型能力填写参考素材；不要把上游images/audios协议混入本站参数。"
      },
      "VideoTask": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "本站任务id"
          },
          "task_id": {
            "type": "string",
            "description": "本站任务id的兼容字段"
          },
          "status": {
            "type": "string",
            "enum": [
              "queued",
              "running",
              "completed",
              "failed"
            ]
          },
          "model": {
            "type": "string"
          },
          "points": {
            "type": "integer"
          },
          "video_url": {
            "type": "string",
            "nullable": true,
            "description": "完整结果地址，可能为本站内容接口或上游签名直链。H3签名当前7天有效，不删exp/sig。"
          },
          "failure_reason": {
            "type": "string",
            "nullable": true
          },
          "upstream_task_id": {
            "type": "string",
            "nullable": true,
            "description": "仅排查用途，不替换本站查询id。"
          },
          "created_at": {
            "type": "integer"
          },
          "updated_at": {
            "type": "integer"
          }
        }
      }
    }
  },
  "externalDocs": {
    "description": "完整中文接入文档",
    "url": "https://yioapp.top/docs/api.html"
  },
  "x-model-snapshot": [
    {
      "code": "chaomeng-video-345b30093bb2",
      "name": "速冲!特价渠道720p Seedance 2.5 满血 (可过真人，不排队)",
      "enabled": true,
      "maintenance": false,
      "durations": [
        15,
        30
      ],
      "resolutions": [
        "720p"
      ],
      "maxReferenceImages": 9,
      "maxReferenceAudios": 0,
      "maxReferenceVideos": 0
    },
    {
      "code": "minimaxh3",
      "name": "MiniMaxH3 2K满血版",
      "enabled": true,
      "maintenance": false,
      "durations": [
        5,
        6,
        7,
        8,
        9,
        10,
        11,
        12,
        13,
        14,
        15
      ],
      "resolutions": [
        "768p"
      ],
      "maxReferenceImages": 8,
      "maxReferenceAudios": 3,
      "maxReferenceVideos": 0
    },
    {
      "code": "sd2_480p_real",
      "name": "SD2.0 720p支持9图3视频3音频，过人脸，不排队",
      "enabled": true,
      "maintenance": false,
      "durations": [
        15
      ],
      "resolutions": [
        "720p"
      ],
      "maxReferenceImages": 9,
      "maxReferenceAudios": 3,
      "maxReferenceVideos": 3
    },
    {
      "code": "sd_2_5_once_720p",
      "name": "SD2.5满血全参30图10视频10音频，原生过人脸，不排队",
      "enabled": true,
      "maintenance": false,
      "durations": [
        30
      ],
      "resolutions": [
        "720p"
      ],
      "maxReferenceImages": 30,
      "maxReferenceAudios": 10,
      "maxReferenceVideos": 10
    },
    {
      "code": "seedance-2.0",
      "name": "Seedance 2.0 · 卡人脸满血版",
      "enabled": true,
      "maintenance": false,
      "durations": [
        5,
        10,
        15
      ],
      "resolutions": [
        "720p"
      ]
    },
    {
      "code": "seedance-2.5",
      "name": "Seedance 2.5 · 卡人脸满血版",
      "enabled": false,
      "maintenance": true,
      "durations": [
        10,
        16,
        20,
        30
      ],
      "resolutions": [
        "720p"
      ]
    },
    {
      "code": "seedance-2.5-special",
      "name": "Seedance 2.5 · 不卡人脸满血版",
      "enabled": false,
      "maintenance": true,
      "durations": [
        30
      ],
      "resolutions": [
        "auto"
      ]
    },
    {
      "code": "seedance-2.5-workflow",
      "name": "Seedance 2.5 · 不卡人脸（90%过）满血版",
      "enabled": false,
      "maintenance": true,
      "durations": [
        30
      ],
      "resolutions": [
        "720p"
      ]
    },
    {
      "code": "feituo_seedance25_discount_720p",
      "name": "特惠 Seedance 2.5 满血 720p",
      "enabled": false,
      "maintenance": false,
      "durations": [
        15,
        30
      ],
      "resolutions": [
        "720p"
      ]
    },
    {
      "code": "lingjing-sd2.5",
      "name": "Seedance2.5·不卡人脸(内置过人脸)满血版",
      "enabled": false,
      "maintenance": true,
      "durations": [
        30
      ],
      "resolutions": [
        "720p"
      ],
      "maxReferenceImages": 30,
      "maxReferenceAudios": 3,
      "maxReferenceVideos": 0
    }
  ]
}