{ "openapi": "3.0.1", "info": { "title": "PopGo API", "version": "1.0.0" }, "servers": [ { "url": "https://api.popgo.site" } ], "security": [ { "BearerAuth": [] } ], "paths": { "/v1/models": { "get": { "summary": "获取模型列表", "deprecated": false, "description": "获取当前可用的模型列表。 根据请求头自动识别返回格式： - 包含 `x-api-key` 和 `anthropic-version` 头时返回 Anthropic 格式 - 包含 `x-goog-api-key` 头或 `key` 查询参数时返回 Gemini 格式 - 其他情况返回 OpenAI 格式", "operationId": "listModels", "tags": [ "获取模型列表" ], "parameters": [ { "name": "key", "in": "query", "description": "Google API Key (用于 Gemini 格式)", "required": false, "schema": { "type": "string" } }, { "name": "x-api-key", "in": "header", "description": "Anthropic API Key (用于 Claude 格式)", "required": false, "schema": { "type": "string" } }, { "name": "anthropic-version", "in": "header", "description": "Anthropic API 版本", "required": false, "schema": { "type": "string" } }, { "name": "x-goog-api-key", "in": "header", "description": "Google API Key (用于 Gemini 格式)", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "成功获取模型列表", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ModelsResponse" } } }, "headers": {} }, "401": { "description": "认证失败", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "headers": {} } }, "security": [ { "BearerAuth": [] } ] } }, "/v1beta/models": { "get": { "summary": "Gemini 格式获取", "deprecated": false, "description": "以 Gemini API 格式返回可用模型列表", "operationId": "listModelsGemini", "tags": [ "获取模型列表" ], "parameters": [], "responses": { "200": { "description": "成功获取模型列表", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GeminiModelsResponse" } } }, "headers": {} } }, "security": [ { "BearerAuth": [] } ] } }, "/v1/chat/completions": { "post": { "summary": "创建聊天对话", "deprecated": false, "description": "根据对话历史创建模型响应。支持流式和非流式响应。 兼容 OpenAI Chat Completions API。", "operationId": "createChatCompletion", "tags": [ "OpenAI格式(Chat)" ], "parameters": [], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ChatCompletionRequest" } } }, "required": true }, "responses": { "200": { "description": "成功创建响应", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ChatCompletionResponse" } } }, "headers": {} }, "400": { "description": "请求参数错误", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "headers": {} }, "429": { "description": "请求频率限制", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "headers": {} } }, "security": [ { "BearerAuth": [] } ] } }, "/v1/responses": { "post": { "summary": "创建响应 (OpenAI Responses API)", "deprecated": false, "description": "OpenAI Responses API，用于创建模型响应。 支持多轮对话、工具调用、推理等功能。", "operationId": "createResponse", "tags": [ "OpenAI格式(Responses)" ], "parameters": [], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResponsesRequest" } } }, "required": true }, "responses": { "200": { "description": "成功创建响应", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResponsesResponse" } } }, "headers": {} } }, "security": [ { "BearerAuth": [] } ] } }, "/v1/responses/compact": { "post": { "summary": "压缩对话 (OpenAI Responses API)", "deprecated": false, "description": "OpenAI Responses API，用于对长对话进行 compaction。", "operationId": "compactResponse", "tags": [ "OpenAI格式(Responses)" ], "parameters": [], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResponsesCompactionRequest" } } }, "required": true }, "responses": { "200": { "description": "成功压缩对话", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResponsesCompactionResponse" } } }, "headers": {} } }, "security": [ { "BearerAuth": [] } ] } }, "/v1/alpha/search": { "post": { "summary": "独立搜索", "description": "仅用于模型目录明确列出此接口的模型。保留兼容客户端提交的原始搜索字段；model、id、stream 仅描述公共请求包络，单独发送 model 不构成完整搜索请求。搜索业务字段和成功响应格式尚无固定公开合同，接入前需取得所用兼容客户端的完整请求规范。", "operationId": "alphaSearch", "tags": [ "搜索" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "model" ], "properties": { "model": { "type": "string", "minLength": 1, "description": "模型目录中支持此接口的完整模型 ID。" }, "id": { "type": "string", "description": "可选的客户端请求标识。" }, "stream": { "type": "boolean", "description": "保留客户端传入的选项；此字段不能保证返回格式为事件流。" } }, "additionalProperties": true, "description": "仅核实了请求包络。其他搜索业务字段由兼容客户端定义并保留，不能从本 schema 推断完整业务请求。" } } } }, "responses": { "2XX": { "description": "成功响应保留实际状态码、Content-Type 与响应内容；无固定 JSON 字段或流格式保证。", "content": { "*/*": { "schema": {} } } }, "default": { "description": "请求失败，读取错误对象并按实际状态码处理。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "BearerAuth": [] } ] } }, "/v1/images/generations": { "post": { "summary": "生成图片", "deprecated": false, "description": "使用所选模型创建图片。通常等待图片结果并返回 200；支持图片任务的请求也可能返回 202，此时保存 id，按 Location 与 Retry-After 查询。字段、取值及素材格式以模型参数表为准。", "operationId": "createImage", "tags": [ "图片生成" ], "parameters": [ { "name": "Prefer", "in": "header", "required": false, "description": "在支持图片任务的模型上使用 respond-async 请求尽早返回任务。即使省略此首部，等待结束后仍可能返回 202；不保证所有模型支持异步。", "schema": { "type": "string" } }, { "name": "Idempotency-Key", "in": "header", "required": false, "description": "在支持图片任务的模型上用于标识一次逻辑请求。同一 API Key 下，相同键和相同请求可返回原任务；相同键配不同请求返回 409。不要依赖不支持任务的模型实现此语义。", "schema": { "type": "string", "maxLength": 255 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PopGoImageCreateRequest" } } } }, "responses": { "200": { "description": "图片生成完成，读取 data 中的 url 或 b64_json。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ImageResponse" } } }, "headers": {} }, "202": { "description": "图片任务已接受或结果仍待确认。保存 id，并按 Location 与 Retry-After 查询；不要自动重复创建。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PopGoImageGenerationJob" } } }, "headers": { "Location": { "description": "任务查询路径。使用同一 API Key 查询此路径。", "schema": { "type": "string" } }, "Retry-After": { "description": "建议在此秒数之后查询任务。", "schema": { "type": "integer", "minimum": 1 } }, "X-Image-Generation-Job-ID": { "description": "已创建的图片任务 ID。", "schema": { "type": "string" } } } }, "400": { "description": "请求无效或图片任务失败；任务失败时响应为图片任务对象。", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/ErrorResponse" }, { "$ref": "#/components/schemas/PopGoImageGenerationJob" } ] } } } }, "409": { "description": "同一幂等键对应了不同请求。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "410": { "description": "任务结果已过期或被清理。", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/ErrorResponse" }, { "$ref": "#/components/schemas/PopGoImageGenerationJob" } ] } } } }, "502": { "description": "任务结果暂时无法取回；保留原任务 ID，稍后查询，不自动重新创建。", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/ErrorResponse" }, { "$ref": "#/components/schemas/PopGoImageGenerationJob" } ] } } } } }, "security": [ { "BearerAuth": [] } ] } }, "/v1/images/edits": { "post": { "summary": "编辑图片", "deprecated": false, "description": "使用所选模型创建图片。通常等待图片结果并返回 200；支持图片任务的请求也可能返回 202，此时保存 id，按 Location 与 Retry-After 查询。字段、取值及素材格式以模型参数表为准。", "operationId": "editImage", "tags": [ "图片生成" ], "parameters": [ { "name": "Prefer", "in": "header", "required": false, "description": "在支持图片任务的模型上使用 respond-async 请求尽早返回任务。即使省略此首部，等待结束后仍可能返回 202；不保证所有模型支持异步。", "schema": { "type": "string" } }, { "name": "Idempotency-Key", "in": "header", "required": false, "description": "在支持图片任务的模型上用于标识一次逻辑请求。同一 API Key 下，相同键和相同请求可返回原任务；相同键配不同请求返回 409。不要依赖不支持任务的模型实现此语义。", "schema": { "type": "string", "maxLength": 255 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PopGoImageEditRequest" } }, "multipart/form-data": { "schema": { "type": "object", "required": [ "model", "prompt" ], "properties": { "model": { "type": "string", "description": "模型目录中的完整模型 ID。" }, "prompt": { "type": "string", "description": "图像内容或编辑要求。" }, "n": { "type": "integer", "minimum": 1, "maximum": 128, "default": 1, "description": "请求图片数量。128 是请求校验上限，各模型可能仅允许更小数量；按模型参数表填写。" }, "size": { "type": "string", "description": "输出尺寸或规格；格式与可用值取决于模型。" }, "resolution": { "type": "string", "description": "仅当模型参数表列出此字段时发送。" }, "aspect_ratio": { "type": "string", "description": "仅当模型参数表列出此字段时发送。" }, "quality": { "type": "string", "description": "仅当模型参数表列出此字段时发送；可用值取决于模型。" }, "response_format": { "type": "string", "description": "常见返回格式为 url 或 b64_json；是否可选及默认值取决于模型。" }, "image": { "oneOf": [ { "type": "string", "format": "binary" }, { "type": "array", "items": { "type": "string", "format": "binary" } } ], "description": "仅用于支持文件上传的模型。字段名、数量及格式按模型参数表填写；多个文件按该模型要求重复字段。" }, "mask": { "type": "string", "format": "binary", "description": "仅用于支持蒙版文件的模型。" } }, "additionalProperties": true } } } }, "responses": { "200": { "description": "图片生成完成，读取 data 中的 url 或 b64_json。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ImageResponse" } } }, "headers": {} }, "202": { "description": "图片任务已接受或结果仍待确认。保存 id，并按 Location 与 Retry-After 查询；不要自动重复创建。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PopGoImageGenerationJob" } } }, "headers": { "Location": { "description": "任务查询路径。使用同一 API Key 查询此路径。", "schema": { "type": "string" } }, "Retry-After": { "description": "建议在此秒数之后查询任务。", "schema": { "type": "integer", "minimum": 1 } }, "X-Image-Generation-Job-ID": { "description": "已创建的图片任务 ID。", "schema": { "type": "string" } } } }, "400": { "description": "请求无效或图片任务失败；任务失败时响应为图片任务对象。", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/ErrorResponse" }, { "$ref": "#/components/schemas/PopGoImageGenerationJob" } ] } } } }, "409": { "description": "同一幂等键对应了不同请求。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "410": { "description": "任务结果已过期或被清理。", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/ErrorResponse" }, { "$ref": "#/components/schemas/PopGoImageGenerationJob" } ] } } } }, "502": { "description": "任务结果暂时无法取回；保留原任务 ID，稍后查询，不自动重新创建。", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/ErrorResponse" }, { "$ref": "#/components/schemas/PopGoImageGenerationJob" } ] } } } } }, "security": [ { "BearerAuth": [] } ] } }, "/v1/image-generation-jobs/{job_id}": { "get": { "summary": "查询图片任务", "description": "使用创建任务的同一 API Key 查询。成功找到任务时返回 HTTP 200，状态在 status 中；生成失败或结果过期也通过任务对象表达，不能仅依据 HTTP 200 判断生成成功。结果可用时读取 data 中的 url 或 b64_json；不可用时检查 result_available 和 error。查询不会创建新图片。", "operationId": "getImageGenerationJob", "tags": [ "图片生成" ], "parameters": [ { "name": "job_id", "in": "path", "required": true, "description": "图片创建响应的 id 或 Location 中的任务 ID。", "schema": { "type": "string" } } ], "responses": { "200": { "description": "任务已找到；检查 status、result_available、data 和 error。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PopGoImageGenerationJob" } } } }, "401": { "description": "API Key 缺失、无效或已禁用。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PopGoImageJobAuthError" } } } }, "403": { "description": "API Key 的 IP 限制或账号状态不允许访问。", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/ErrorResponse" }, { "$ref": "#/components/schemas/PopGoImageJobAuthError" } ] } } } }, "404": { "description": "任务不存在，或不属于当前 API Key。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "暂时无法验证凭据或读取账号状态。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PopGoImageJobAuthError" } } } } }, "security": [ { "BearerAuth": [] } ] } }, "/v1/videos": { "post": { "summary": "创建视频", "deprecated": false, "description": "创建异步视频任务。参考素材使用 HTTPS URL；请求字段按所选模型的参数表填写。", "operationId": "createVideo", "tags": [ "视频生成" ], "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/PopGoVideoRequest1Json" }, { "$ref": "#/components/schemas/PopGoVideoRequest2Json" }, { "$ref": "#/components/schemas/PopGoVideoRequest3Json" }, { "$ref": "#/components/schemas/PopGoVideoRequest4Json" }, { "$ref": "#/components/schemas/PopGoVideoRequest5Json" }, { "$ref": "#/components/schemas/PopGoVideoRequest6Json" }, { "$ref": "#/components/schemas/PopGoVideoRequest7Json" }, { "$ref": "#/components/schemas/PopGoVideoRequest8Json" }, { "$ref": "#/components/schemas/PopGoVideoRequest9Json" }, { "$ref": "#/components/schemas/PopGoVideoRequest10Json" }, { "$ref": "#/components/schemas/PopGoVideoRequest11Json" }, { "$ref": "#/components/schemas/PopGoVideoRequest12Json" }, { "$ref": "#/components/schemas/PopGoVideoRequest13Json" }, { "$ref": "#/components/schemas/PopGoVideoRequest14Json" }, { "$ref": "#/components/schemas/PopGoVideoRequest15Json" }, { "$ref": "#/components/schemas/PopGoVideoRequest16Json" }, { "$ref": "#/components/schemas/PopGoVideoRequest17Json" }, { "$ref": "#/components/schemas/PopGoVideoRequest18Json" }, { "$ref": "#/components/schemas/PopGoVideoRequest19Json" }, { "$ref": "#/components/schemas/PopGoVideoRequest20Json" }, { "$ref": "#/components/schemas/PopGoVideoRequest21Json" }, { "$ref": "#/components/schemas/PopGoVideoRequest22Json" }, { "$ref": "#/components/schemas/PopGoVideoRequest23Json" }, { "$ref": "#/components/schemas/PopGoVideoRequest24Json" }, { "$ref": "#/components/schemas/PopGoVideoRequest25Json" }, { "$ref": "#/components/schemas/PopGoVideoRequest26Json" }, { "$ref": "#/components/schemas/PopGoVideoRequest27Json" }, { "$ref": "#/components/schemas/PopGoVideoRequest28Json" }, { "$ref": "#/components/schemas/PopGoVideoRequest29Json" }, { "$ref": "#/components/schemas/PopGoVideoRequest30Json" }, { "$ref": "#/components/schemas/PopGoVideoRequest31Json" }, { "$ref": "#/components/schemas/PopGoVideoRequest32Json" }, { "$ref": "#/components/schemas/PopGoVideoRequest33Json" }, { "$ref": "#/components/schemas/PopGoVideoRequest34Json" }, { "$ref": "#/components/schemas/PopGoVideoRequest35Json" }, { "$ref": "#/components/schemas/PopGoVideoRequest36Json" }, { "$ref": "#/components/schemas/PopGoVideoRequest37Json" }, { "$ref": "#/components/schemas/PopGoVideoRequest38Json" }, { "$ref": "#/components/schemas/PopGoVideoRequest39Json" }, { "$ref": "#/components/schemas/PopGoVideoRequest40Json" }, { "$ref": "#/components/schemas/PopGoVideoRequest41Json" }, { "$ref": "#/components/schemas/PopGoVideoRequest42Json" }, { "$ref": "#/components/schemas/PopGoVideoRequest43Json" }, { "$ref": "#/components/schemas/PopGoVideoRequest44Json" }, { "$ref": "#/components/schemas/PopGoVideoRequest45Json" }, { "$ref": "#/components/schemas/PopGoVideoRequest46Json" }, { "$ref": "#/components/schemas/PopGoVideoRequest47Json" }, { "$ref": "#/components/schemas/PopGoVideoRequest48Json" }, { "$ref": "#/components/schemas/PopGoVideoRequest49Json" }, { "$ref": "#/components/schemas/PopGoVideoRequest50Json" }, { "$ref": "#/components/schemas/PopGoVideoRequest51Json" }, { "$ref": "#/components/schemas/PopGoVideoRequest52Json" }, { "$ref": "#/components/schemas/PopGoVideoRequest53Json" }, { "$ref": "#/components/schemas/PopGoVideoRequest54Json" }, { "$ref": "#/components/schemas/PopGoVideoRequest56Json" }, { "$ref": "#/components/schemas/PopGoVideoRequest57Json" }, { "$ref": "#/components/schemas/PopGoVideoRequest58Json" }, { "$ref": "#/components/schemas/PopGoVideoRequest59Json" } ] } } } }, "responses": { "200": { "description": "成功创建视频任务", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OpenAIVideo" } } }, "headers": {} }, "400": { "description": "请求参数错误", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "headers": {} } }, "security": [ { "BearerAuth": [] } ] } }, "/v1/videos/{task_id}": { "get": { "summary": "获取视频任务状态", "deprecated": false, "description": "查询视频任务状态。任务完成后，使用创建任务时的 API Key 调用内容接口获取视频。", "operationId": "getVideo", "tags": [ "视频生成" ], "parameters": [ { "name": "task_id", "in": "path", "description": "视频任务 ID", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "成功获取视频任务状态", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OpenAIVideo" } } }, "headers": {} }, "404": { "description": "任务不存在", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "headers": {} } }, "security": [ { "BearerAuth": [] } ] } }, "/v1/videos/{task_id}/content": { "get": { "summary": "获取视频内容", "deprecated": false, "description": "下载已完成任务的视频文件。请求时携带与创建任务相同的 API Key。", "operationId": "getVideoContent", "tags": [ "视频生成" ], "parameters": [ { "name": "task_id", "in": "path", "description": "视频任务 ID", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "成功获取视频内容", "content": { "video/mp4": { "schema": { "type": "string", "format": "binary" } } }, "headers": {} }, "400": { "description": "任务失败或请求无效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "任务不存在或无权访问", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "409": { "description": "任务尚未完成，请继续查询状态", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "BearerAuth": [] } ] } }, "/v1/messages": { "post": { "summary": "Claude 聊天", "deprecated": false, "description": "Anthropic Claude Messages API 格式的请求。 需要在请求头中包含 `anthropic-version`。", "operationId": "createMessage", "tags": [ "Claude格式(Messages)" ], "parameters": [ { "name": "anthropic-version", "in": "header", "description": "Anthropic API 版本", "required": true, "schema": { "type": "string" } }, { "name": "x-api-key", "in": "header", "description": "Anthropic API Key (可选，也可使用 Bearer Token)", "required": false, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClaudeRequest" } } } }, "responses": { "200": { "description": "成功创建响应", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClaudeResponse" } } }, "headers": {} } }, "security": [ { "BearerAuth": [] } ] } }, "/v1beta/models/{model}:generateContent": { "post": { "summary": "Gemini 图片(Nano Banana)", "deprecated": false, "description": "Gemini 图片生成", "operationId": "geminiRelayV1Beta", "tags": [ "Gemini格式" ], "parameters": [ { "name": "model", "in": "path", "description": "模型名称", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "contents": { "type": "array", "items": { "type": "object", "properties": { "role": { "type": "string" }, "parts": { "type": "array", "items": { "type": "object", "properties": { "text": { "type": "string" } } } } } } }, "generationConfig": { "type": "object", "properties": { "responseModalities": { "type": "array", "items": { "type": "string" } }, "imageConfig": { "type": "object", "properties": { "aspectRatio": { "type": "string" }, "imageSize": { "type": "string" } } } }, "required": [ "responseModalities" ] } }, "required": [ "contents", "generationConfig" ] } } } }, "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GeminiResponse" } } }, "headers": {} } }, "security": [ { "BearerAuth": [] } ] } }, "/v1/engines/{model}/embeddings": { "post": { "summary": "Gemini 嵌入(Embeddings)", "deprecated": false, "description": "使用指定引擎/模型创建嵌入", "operationId": "createEngineEmbedding", "tags": [ "Gemini格式" ], "parameters": [ { "name": "model", "in": "path", "description": "模型/引擎 ID", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EmbeddingRequest" } } } }, "responses": { "200": { "description": "成功创建嵌入", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EmbeddingResponse" } } }, "headers": {} } }, "security": [ { "BearerAuth": [] } ] } }, "/v1/embeddings": { "post": { "summary": "创建文本嵌入", "deprecated": false, "description": "将文本转换为向量嵌入", "operationId": "createEmbedding", "tags": [ "OpenAI格式(Embeddings)" ], "parameters": [], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EmbeddingRequest" } } }, "required": true }, "responses": { "200": { "description": "成功创建嵌入", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EmbeddingResponse" } } }, "headers": {} } }, "security": [ { "BearerAuth": [] } ] } }, "/v1/completions": { "post": { "summary": "创建文本补全", "deprecated": false, "description": "基于给定提示创建文本补全", "operationId": "createCompletion", "tags": [ "文本补全(Completions)" ], "parameters": [], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CompletionRequest" } } }, "required": true }, "responses": { "200": { "description": "成功创建响应", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CompletionResponse" } } }, "headers": {} } }, "security": [ { "BearerAuth": [] } ] } }, "/v1/audio/transcriptions": { "post": { "summary": "音频转录", "deprecated": false, "description": "将音频转换为文本", "operationId": "createTranscription", "tags": [ "OpenAI音频(Audio)" ], "parameters": [], "requestBody": { "content": { "multipart/form-data": { "schema": { "type": "object", "properties": { "file": { "type": "string", "format": "binary", "description": "音频文件" }, "model": { "type": "string" }, "language": { "type": "string", "description": "ISO-639-1 语言代码" }, "prompt": { "type": "string" }, "response_format": { "type": "string", "enum": [ "json", "text", "srt", "verbose_json", "vtt" ], "default": "json" }, "temperature": { "type": "number" }, "timestamp_granularities": { "type": "array", "items": { "type": "string", "enum": [ "word", "segment" ] } } }, "required": [ "file", "model" ] } } }, "required": true }, "responses": { "200": { "description": "成功转录", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AudioTranscriptionResponse" } } }, "headers": {} } }, "security": [ { "BearerAuth": [] } ] } }, "/v1/audio/translations": { "post": { "summary": "音频翻译", "deprecated": false, "description": "将音频翻译为英文文本", "operationId": "createTranslation", "tags": [ "OpenAI音频(Audio)" ], "parameters": [], "requestBody": { "content": { "multipart/form-data": { "schema": { "type": "object", "properties": { "file": { "type": "string", "format": "binary" }, "model": { "type": "string" }, "prompt": { "type": "string" }, "response_format": { "type": "string" }, "temperature": { "type": "number" } }, "required": [ "file", "model" ] } } }, "required": true }, "responses": { "200": { "description": "成功翻译", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AudioTranscriptionResponse" } } }, "headers": {} } }, "security": [ { "BearerAuth": [] } ] } }, "/v1/audio/speech": { "post": { "summary": "文本转语音", "deprecated": false, "description": "将文本转换为音频", "operationId": "createSpeech", "tags": [ "OpenAI音频(Audio)" ], "parameters": [], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SpeechRequest" } } }, "required": true }, "responses": { "200": { "description": "成功生成音频", "content": { "audio/mpeg": { "schema": { "type": "string", "format": "binary" } } }, "headers": {} } }, "security": [ { "BearerAuth": [] } ] } }, "/v1/rerank": { "post": { "summary": "文档重排序", "deprecated": false, "description": "根据查询对文档列表进行相关性重排序", "operationId": "createRerank", "tags": [ "重排序(Rerank)" ], "parameters": [], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RerankRequest" } } }, "required": true }, "responses": { "200": { "description": "成功重排序", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RerankResponse" } } }, "headers": {} } }, "security": [ { "BearerAuth": [] } ] } }, "/v1/moderations": { "post": { "summary": "内容审核", "deprecated": false, "description": "检查文本内容是否违反使用政策", "operationId": "createModeration", "tags": [ "Moderations" ], "parameters": [], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ModerationRequest" } } }, "required": true }, "responses": { "200": { "description": "成功审核", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ModerationResponse" } } }, "headers": {} } }, "security": [ { "BearerAuth": [] } ] } }, "/v1/realtime": { "get": { "summary": "实时 WebSocket 连接", "deprecated": false, "description": "建立 WebSocket 连接用于实时对话。 **注意**: 这是一个 WebSocket 端点，需要使用 WebSocket 协议连接。 连接 URL 示例: ``", "operationId": "createRealtimeSession", "tags": [ "Realtime" ], "parameters": [ { "name": "model", "in": "query", "description": "要使用的模型", "required": false, "schema": { "type": "string" } } ], "responses": { "101": { "description": "WebSocket 协议切换", "headers": {} }, "400": { "description": "请求错误", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "headers": {} } }, "security": [ { "BearerAuth": [] } ] } } }, "components": { "schemas": { "ModelsResponse": { "type": "object", "properties": { "object": { "type": "string" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/Model" } } } }, "ErrorResponse": { "type": "object", "properties": { "error": { "type": "object", "properties": { "message": { "type": "string", "description": "错误信息" }, "type": { "type": "string", "description": "错误类型" }, "param": { "type": "string", "description": "相关参数", "nullable": true }, "code": { "type": "string", "description": "错误代码", "nullable": true } } } } }, "GeminiModelsResponse": { "type": "object", "properties": { "models": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "version": { "type": "string" }, "displayName": { "type": "string" }, "description": { "type": "string" }, "inputTokenLimit": { "type": "integer" }, "outputTokenLimit": { "type": "integer" }, "supportedGenerationMethods": { "type": "array", "items": { "type": "string" } } } } } } }, "ChatCompletionRequest": { "type": "object", "required": [ "model", "messages" ], "properties": { "model": { "type": "string", "description": "模型 ID" }, "messages": { "type": "array", "items": { "$ref": "#/components/schemas/Message" }, "description": "对话消息列表" }, "temperature": { "type": "number", "minimum": 0, "maximum": 2, "default": 1, "description": "采样温度" }, "top_p": { "type": "number", "minimum": 0, "maximum": 1, "default": 1, "description": "核采样参数" }, "n": { "type": "integer", "minimum": 1, "default": 1, "description": "生成数量" }, "stream": { "type": "boolean", "default": false, "description": "是否流式响应" }, "stream_options": { "type": "object", "properties": { "include_usage": { "type": "boolean" } } }, "stop": { "oneOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ], "description": "停止序列" }, "max_tokens": { "type": "integer", "description": "最大生成 Token 数" }, "max_completion_tokens": { "type": "integer", "description": "最大补全 Token 数" }, "presence_penalty": { "type": "number", "minimum": -2, "maximum": 2, "default": 0 }, "frequency_penalty": { "type": "number", "minimum": -2, "maximum": 2, "default": 0 }, "logit_bias": { "type": "object", "additionalProperties": { "type": "number" }, "properties": {} }, "user": { "type": "string" }, "tools": { "type": "array", "items": { "$ref": "#/components/schemas/Tool" } }, "tool_choice": { "oneOf": [ { "type": "string", "enum": [ "none", "auto", "required" ] }, { "type": "object", "properties": { "type": { "type": "string" }, "function": { "type": "object", "properties": { "name": { "type": "string" } } } } } ] }, "response_format": { "$ref": "#/components/schemas/ResponseFormat" }, "seed": { "type": "integer" }, "reasoning_effort": { "type": "string", "enum": [ "low", "medium", "high" ], "description": "推理强度 (用于支持推理的模型)" }, "modalities": { "type": "array", "items": { "type": "string", "enum": [ "text", "audio" ] } }, "audio": { "type": "object", "properties": { "voice": { "type": "string" }, "format": { "type": "string" } } } } }, "ChatCompletionResponse": { "type": "object", "properties": { "id": { "type": "string" }, "object": { "type": "string" }, "created": { "type": "integer" }, "model": { "type": "string" }, "choices": { "type": "array", "items": { "type": "object", "properties": { "index": { "type": "integer" }, "message": { "$ref": "#/components/schemas/Message" }, "finish_reason": { "type": "string", "enum": [ "stop", "length", "tool_calls", "content_filter" ] } } } }, "usage": { "$ref": "#/components/schemas/Usage" }, "system_fingerprint": { "type": "string" } } }, "ResponsesRequest": { "type": "object", "required": [ "model" ], "properties": { "model": { "type": "string" }, "input": { "description": "输入内容，可以是字符串或消息数组", "oneOf": [ { "type": "string" }, { "type": "array", "items": { "type": "object", "properties": {} } } ] }, "instructions": { "type": "string" }, "max_output_tokens": { "type": "integer" }, "temperature": { "type": "number" }, "top_p": { "type": "number" }, "stream": { "type": "boolean" }, "tools": { "type": "array", "items": { "type": "object", "properties": {} } }, "tool_choice": { "oneOf": [ { "type": "string" }, { "type": "object", "properties": {} } ] }, "reasoning": { "type": "object", "properties": { "effort": { "type": "string", "enum": [ "low", "medium", "high" ] }, "summary": { "type": "string" } } }, "previous_response_id": { "type": "string" }, "truncation": { "type": "string", "enum": [ "auto", "disabled" ] } } }, "ResponsesResponse": { "type": "object", "properties": { "id": { "type": "string" }, "object": { "type": "string" }, "created_at": { "type": "integer" }, "status": { "type": "string", "enum": [ "completed", "failed", "in_progress", "incomplete" ] }, "model": { "type": "string" }, "output": { "type": "array", "items": { "type": "object", "properties": { "type": { "type": "string" }, "id": { "type": "string" }, "status": { "type": "string" }, "role": { "type": "string" }, "content": { "type": "array", "items": { "type": "object", "properties": { "type": { "type": "string" }, "text": { "type": "string" } } } } } } }, "usage": { "$ref": "#/components/schemas/Usage" } } }, "ResponsesCompactionRequest": { "type": "object", "required": [ "model" ], "properties": { "model": { "type": "string" }, "input": { "description": "输入内容，可以是字符串或消息数组", "oneOf": [ { "type": "string" }, { "type": "array", "items": { "type": "object", "properties": {} } } ] }, "instructions": { "type": "string" }, "previous_response_id": { "type": "string" } } }, "ResponsesCompactionResponse": { "type": "object", "properties": { "id": { "type": "string" }, "object": { "type": "string" }, "created_at": { "type": "integer" }, "output": { "type": "array", "items": { "type": "object", "properties": {} } }, "usage": { "$ref": "#/components/schemas/Usage" }, "error": { "type": "object", "properties": {} } } }, "PopGoImageCreateRequest": { "type": "object", "required": [ "model", "prompt" ], "properties": { "model": { "type": "string", "description": "模型目录中的完整模型 ID。" }, "prompt": { "type": "string", "description": "图像内容或编辑要求。" }, "n": { "type": "integer", "minimum": 1, "maximum": 128, "default": 1, "description": "请求图片数量。128 是请求校验上限，各模型可能仅允许更小数量；按模型参数表填写。" }, "size": { "type": "string", "description": "输出尺寸或规格；格式与可用值取决于模型。" }, "resolution": { "type": "string", "description": "仅当模型参数表列出此字段时发送。" }, "aspect_ratio": { "type": "string", "description": "仅当模型参数表列出此字段时发送。" }, "quality": { "type": "string", "description": "仅当模型参数表列出此字段时发送；可用值取决于模型。" }, "response_format": { "type": "string", "description": "常见返回格式为 url 或 b64_json；是否可选及默认值取决于模型。" } }, "additionalProperties": true, "description": "图片生成基础请求。额外字段、值域和默认值须按所选模型参数表填写，不能视为所有模型通用能力。" }, "ImageResponse": { "type": "object", "properties": { "created": { "type": "integer" }, "data": { "type": "array", "items": { "type": "object", "properties": { "url": { "type": "string" }, "b64_json": { "type": "string" }, "revised_prompt": { "type": "string" } } } } } }, "PopGoImageGenerationJob": { "type": "object", "required": [ "id", "job_id", "object", "model", "endpoint", "status", "created_at", "updated_at", "result_available" ], "properties": { "id": { "type": "string", "description": "图片任务 ID。" }, "job_id": { "type": "string", "description": "与 id 相同。" }, "client_job_id": { "type": "string", "description": "客户端请求标识；未提供时可能为空。" }, "object": { "type": "string", "enum": [ "image_generation.job" ] }, "model": { "type": "string", "description": "创建任务时使用的模型 ID。" }, "endpoint": { "type": "string", "description": "创建任务的接口类别。" }, "status": { "type": "string", "enum": [ "pending", "submitted", "processing", "succeeded", "failed", "uncertain" ], "description": "pending/submitted/processing：继续查询；succeeded：检查 result_available 和 data；failed：停止查询并读取 error；uncertain：结果待确认，保留任务 ID 查询或联系支持，不自动重新创建。" }, "created_at": { "type": "integer", "format": "int64", "description": "创建时间，Unix 秒。" }, "updated_at": { "type": "integer", "format": "int64", "description": "更新时间，Unix 秒。" }, "expires_at": { "type": "integer", "format": "int64", "description": "可用时返回的过期时间，Unix 秒。" }, "result_available": { "type": "boolean", "description": "当前响应是否包含可读取的 data。succeeded 不保证结果仍可用，应同时检查此字段。" }, "data": { "type": "array", "description": "有可用结果时返回；读取每项 url 或 b64_json。", "items": { "type": "object", "properties": { "url": { "type": "string", "description": "图片地址；某些返回格式下可为空，使用 b64_json。" }, "b64_json": { "type": "string", "description": "图片 Base64 数据；并非所有结果包含。" }, "asset_id": { "type": "string", "description": "可用时返回的素材 ID。" }, "mime_type": { "type": "string" }, "bytes": { "type": "integer", "format": "int64", "minimum": 0 } }, "additionalProperties": true } }, "error": { "type": "object", "description": "任务失败、结果不可取回或结果待确认时返回。", "properties": { "code": { "type": "string" }, "message": { "type": "string" } }, "additionalProperties": true } }, "additionalProperties": true }, "PopGoImageEditRequest": { "type": "object", "required": [ "model", "prompt" ], "properties": { "model": { "type": "string", "description": "模型目录中的完整模型 ID。" }, "prompt": { "type": "string", "description": "图像内容或编辑要求。" }, "n": { "type": "integer", "minimum": 1, "maximum": 128, "default": 1, "description": "请求图片数量。128 是请求校验上限，各模型可能仅允许更小数量；按模型参数表填写。" }, "size": { "type": "string", "description": "输出尺寸或规格；格式与可用值取决于模型。" }, "resolution": { "type": "string", "description": "仅当模型参数表列出此字段时发送。" }, "aspect_ratio": { "type": "string", "description": "仅当模型参数表列出此字段时发送。" }, "quality": { "type": "string", "description": "仅当模型参数表列出此字段时发送；可用值取决于模型。" }, "response_format": { "type": "string", "description": "常见返回格式为 url 或 b64_json；是否可选及默认值取决于模型。" }, "image": { "description": "参考图片。JSON 结构、URL/Base64 支持情况及数量按所选模型参数表填写。" }, "images": { "description": "仅用于参数表列出 images 的模型；结构与限制按该模型填写。" }, "mask": { "description": "仅用于参数表明确支持蒙版的模型。" } }, "additionalProperties": true, "description": "图片编辑基础请求。参考图片字段与格式取决于模型；不应将 image 和 images 混用。" }, "PopGoImageJobAuthError": { "type": "object", "required": [ "success", "message" ], "properties": { "success": { "type": "boolean", "enum": [ false ] }, "message": { "type": "string" } } }, "PopGoVideoRequest1Json": { "type": "object", "properties": { "model": { "type": "string", "enum": [ "grok-imagine-video-1.5" ] }, "prompt": { "type": "string", "minLength": 1, "description": "Describe the desired scene and motion." }, "seconds": { "type": "string", "enum": [ "1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15" ], "description": "Output duration in seconds; use the range or values listed here." }, "resolution": { "type": "string", "enum": [ "480p", "720p", "1080p" ], "description": "Output resolution; values are case-sensitive." }, "aspect_ratio": { "type": "string", "enum": [ "1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3" ], "description": "Output aspect ratio." }, "input_reference": { "type": "object", "additionalProperties": false, "properties": { "image_url": { "type": "string", "format": "uri", "pattern": "^https://" } }, "required": [ "image_url" ], "description": "One first-frame image as an object: image_url is a publicly downloadable HTTPS URL." }, "reference_images": { "type": "array", "minItems": 7, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." } }, "required": [ "model", "prompt" ], "additionalProperties": true }, "PopGoVideoRequest2Json": { "type": "object", "properties": { "model": { "type": "string", "enum": [ "JIAS-Grok-video-1.5" ] }, "prompt": { "type": "string", "minLength": 1, "maxLength": 6000, "description": "Describe the desired scene and motion." }, "seconds": { "type": "string", "default": "5", "enum": [ "3", "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15" ], "description": "Output duration in seconds; use the range or values listed here." }, "resolution": { "type": "string", "default": "720p", "enum": [ "720p" ], "description": "Output resolution; values are case-sensitive." }, "aspect_ratio": { "type": "string", "enum": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ], "description": "Output aspect ratio." }, "face": { "type": "object", "properties": { "enabled": { "type": "boolean" }, "mode": { "type": "string", "enum": [ "light", "heavy" ] } }, "required": [ "enabled" ], "description": "Optional face object. If supplied, `enabled` is a required boolean; when true, `mode` must be `light` or `heavy`." }, "reference_images": { "type": "array", "maxItems": 7, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." } }, "required": [ "model", "prompt" ], "additionalProperties": true }, "PopGoVideoRequest3Json": { "type": "object", "properties": { "model": { "type": "string", "enum": [ "JIAS-SD2.0-720P" ] }, "prompt": { "type": "string", "minLength": 1, "maxLength": 6000, "description": "Describe the desired scene and motion." }, "seconds": { "type": "string", "default": "5", "enum": [ "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15" ], "description": "Output duration in seconds; use the range or values listed here." }, "resolution": { "type": "string", "default": "720p", "enum": [ "720p" ], "description": "Output resolution; values are case-sensitive." }, "aspect_ratio": { "type": "string", "enum": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ], "description": "Output aspect ratio." }, "face": { "type": "object", "properties": { "enabled": { "type": "boolean" }, "mode": { "type": "string", "enum": [ "light", "heavy" ] } }, "required": [ "enabled" ], "description": "Optional face object. If supplied, `enabled` is a required boolean; when true, `mode` must be `light` or `heavy`." }, "reference_images": { "type": "array", "maxItems": 9, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "reference_videos": { "type": "array", "maxItems": 3, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "reference_audios": { "type": "array", "maxItems": 3, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." } }, "required": [ "model", "prompt" ], "additionalProperties": true }, "PopGoVideoRequest4Json": { "type": "object", "properties": { "model": { "type": "string", "enum": [ "JIAS-SD2.0-Pro" ] }, "prompt": { "type": "string", "minLength": 1, "maxLength": 6000, "description": "Describe the desired scene and motion." }, "seconds": { "type": "string", "default": "5", "enum": [ "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15" ], "description": "Output duration in seconds; use the range or values listed here." }, "resolution": { "type": "string", "default": "720p", "enum": [ "720p" ], "description": "Output resolution; values are case-sensitive." }, "aspect_ratio": { "type": "string", "enum": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ], "description": "Output aspect ratio." }, "face": { "type": "object", "properties": { "enabled": { "type": "boolean" }, "mode": { "type": "string", "enum": [ "light", "heavy" ] } }, "required": [ "enabled" ], "description": "Optional face object. If supplied, `enabled` is a required boolean; when true, `mode` must be `light` or `heavy`." }, "reference_images": { "type": "array", "maxItems": 9, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "reference_videos": { "type": "array", "maxItems": 3, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "reference_audios": { "type": "array", "maxItems": 3, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." } }, "required": [ "model", "prompt" ], "additionalProperties": true }, "PopGoVideoRequest5Json": { "type": "object", "properties": { "model": { "type": "string", "enum": [ "JIAS-SD2.5-Pro" ] }, "prompt": { "type": "string", "minLength": 1, "maxLength": 6000, "description": "Describe the desired scene and motion." }, "seconds": { "type": "string", "default": "5", "enum": [ "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20", "21", "22", "23", "24", "25", "26", "27", "28", "29", "30" ], "description": "Output duration in seconds; use the range or values listed here." }, "resolution": { "type": "string", "default": "720p", "enum": [ "480p", "720p" ], "description": "Output resolution; values are case-sensitive." }, "aspect_ratio": { "type": "string", "enum": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ], "description": "Output aspect ratio." }, "face": { "type": "object", "properties": { "enabled": { "type": "boolean" }, "mode": { "type": "string", "enum": [ "light", "heavy" ] } }, "required": [ "enabled" ], "description": "Optional face object. If supplied, `enabled` is a required boolean; when true, `mode` must be `light` or `heavy`." }, "reference_images": { "type": "array", "maxItems": 30, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "reference_videos": { "type": "array", "maxItems": 10, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "reference_audios": { "type": "array", "maxItems": 10, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." } }, "required": [ "model", "prompt" ], "additionalProperties": true }, "PopGoVideoRequest6Json": { "type": "object", "properties": { "model": { "type": "string", "enum": [ "kling-video-v3" ] }, "prompt": { "type": "string", "minLength": 1, "description": "Describe the desired scene and motion." }, "seconds": { "type": "string", "default": "5", "enum": [ "3", "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15" ], "description": "Output duration in seconds; use the range or values listed here." }, "resolution": { "type": "string", "enum": [ "720p", "1080p", "4K" ], "description": "Output resolution; values are case-sensitive." }, "aspect_ratio": { "type": "string", "enum": [ "16:9", "9:16", "1:1" ], "description": "Output aspect ratio." }, "generate_audio": { "type": "boolean", "description": "Whether to generate an output audio track. Explicit false is supported." }, "reference_images": { "type": "array", "maxItems": 2, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "first_frame": { "type": "string", "format": "uri", "pattern": "^https://", "description": "First-frame image as a publicly downloadable HTTPS URL; follow this model’s frame-combination rules." }, "last_frame": { "type": "string", "format": "uri", "pattern": "^https://", "description": "Last-frame image as a publicly downloadable HTTPS URL; follow this model’s frame-combination rules." } }, "required": [ "model", "prompt" ], "additionalProperties": true }, "PopGoVideoRequest7Json": { "type": "object", "properties": { "model": { "type": "string", "enum": [ "kling-video-v3-omni" ] }, "prompt": { "type": "string", "minLength": 1, "description": "Describe the desired scene and motion." }, "seconds": { "type": "string", "default": "5", "enum": [ "3", "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15" ], "description": "Output duration in seconds; use the range or values listed here." }, "resolution": { "type": "string", "enum": [ "720p", "1080p", "4K" ], "description": "Output resolution; values are case-sensitive." }, "aspect_ratio": { "type": "string", "enum": [ "16:9", "9:16", "1:1" ], "description": "Output aspect ratio." }, "generate_audio": { "type": "boolean", "description": "Whether to generate an output audio track. Explicit false is supported." }, "reference_images": { "type": "array", "maxItems": 7, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." } }, "required": [ "model", "prompt" ], "additionalProperties": true }, "PopGoVideoRequest8Json": { "type": "object", "properties": { "model": { "type": "string", "enum": [ "kling-video-v3-turbo" ] }, "prompt": { "type": "string", "minLength": 1, "description": "Describe the desired scene and motion." }, "seconds": { "type": "string", "default": "5", "enum": [ "3", "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15" ], "description": "Output duration in seconds; use the range or values listed here." }, "resolution": { "type": "string", "enum": [ "720p", "1080p" ], "description": "Output resolution; values are case-sensitive." }, "aspect_ratio": { "type": "string", "enum": [ "16:9", "9:16", "1:1" ], "description": "Output aspect ratio." }, "reference_images": { "type": "array", "maxItems": 1, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." } }, "required": [ "model", "prompt" ], "additionalProperties": true }, "PopGoVideoRequest9Json": { "type": "object", "properties": { "model": { "type": "string", "enum": [ "minimaxH3-A" ] }, "prompt": { "type": "string", "minLength": 1, "description": "Describe the desired scene and motion." }, "seconds": { "type": "string", "default": "4", "enum": [ "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15" ], "description": "Output duration in seconds; use the range or values listed here." }, "resolution": { "type": "string", "enum": [ "480p", "720p", "1080p" ], "description": "Output resolution; values are case-sensitive." }, "aspect_ratio": { "type": "string", "enum": [ "16:9", "9:16" ], "description": "Output aspect ratio." }, "generate_audio": { "type": "boolean", "description": "Whether to generate an output audio track. Explicit false is supported." }, "reference_images": { "type": "array", "maxItems": 9, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "reference_videos": { "type": "array", "maxItems": 3, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "reference_audios": { "type": "array", "maxItems": 3, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." } }, "required": [ "model", "prompt" ], "additionalProperties": true }, "PopGoVideoRequest10Json": { "type": "object", "properties": { "model": { "type": "string", "enum": [ "MX-SD-2.5-B" ] }, "prompt": { "type": "string", "minLength": 1, "maxLength": 10000, "description": "Describe the desired scene and motion." }, "seconds": { "type": "string", "enum": [ "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20", "21", "22", "23", "24", "25", "26", "27", "28", "29", "30" ], "description": "Output duration in seconds; use the range or values listed here." }, "resolution": { "type": "string", "enum": [ "720p" ], "description": "Output resolution; values are case-sensitive." }, "aspect_ratio": { "type": "string", "enum": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ], "description": "Output aspect ratio." }, "mode": { "type": "string", "enum": [ "文生视频", "图生视频", "多模态" ], "description": "Optional mode; omit for automatic selection. Accepted protocol values are `文生视频`, `图生视频` and `多模态`." }, "reference_images": { "type": "array", "maxItems": 30, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "reference_videos": { "type": "array", "maxItems": 10, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "reference_audios": { "type": "array", "maxItems": 10, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." } }, "required": [ "model", "prompt", "seconds", "resolution", "aspect_ratio" ], "additionalProperties": true }, "PopGoVideoRequest11Json": { "type": "object", "properties": { "model": { "type": "string", "enum": [ "MX-SD-2.5-A" ] }, "prompt": { "type": "string", "minLength": 1, "description": "Describe the desired scene and motion." }, "seconds": { "type": "string", "default": "10", "enum": [ "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20", "21", "22", "23", "24", "25", "26", "27", "28", "29", "30" ], "description": "Output duration in seconds; use the range or values listed here." }, "resolution": { "type": "string", "default": "720p", "enum": [ "720p" ], "description": "Output resolution; values are case-sensitive." }, "aspect_ratio": { "type": "string", "default": "16:9", "enum": [ "21:9", "16:9", "4:3", "1:1", "3:4", "9:16" ], "description": "Output aspect ratio." }, "reference_images": { "type": "array", "maxItems": 30, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "reference_videos": { "type": "array", "maxItems": 10, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "reference_audios": { "type": "array", "maxItems": 10, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." } }, "required": [ "model", "prompt" ], "additionalProperties": true }, "PopGoVideoRequest12Json": { "type": "object", "properties": { "model": { "type": "string", "enum": [ "MX-SD-2.5-A2" ] }, "prompt": { "type": "string", "minLength": 1, "description": "Describe the desired scene and motion." }, "seconds": { "type": "string", "default": "10", "enum": [ "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20", "21", "22", "23", "24", "25", "26", "27", "28", "29", "30" ], "description": "Output duration in seconds; use the range or values listed here." }, "resolution": { "type": "string", "default": "720p", "enum": [ "720p" ], "description": "Output resolution; values are case-sensitive." }, "aspect_ratio": { "type": "string", "default": "16:9", "enum": [ "21:9", "16:9", "4:3", "1:1", "3:4", "9:16" ], "description": "Output aspect ratio." }, "reference_images": { "type": "array", "maxItems": 30, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "reference_videos": { "type": "array", "maxItems": 10, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "reference_audios": { "type": "array", "maxItems": 10, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." } }, "required": [ "model", "prompt" ], "additionalProperties": true }, "PopGoVideoRequest13Json": { "type": "object", "properties": { "model": { "type": "string", "enum": [ "RuoX-SD2.5" ] }, "prompt": { "type": "string", "minLength": 1, "description": "Describe the desired scene and motion." }, "seconds": { "type": "string", "default": "5", "enum": [ "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20", "21", "22", "23", "24", "25", "26", "27", "28", "29", "30" ], "description": "Output duration in seconds; use the range or values listed here." }, "resolution": { "type": "string", "default": "480p", "enum": [ "480p", "720p" ], "description": "Output resolution; values are case-sensitive." }, "aspect_ratio": { "type": "string", "enum": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9", "adaptive" ], "description": "Output aspect ratio." }, "reference_images": { "type": "array", "maxItems": 30, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "reference_videos": { "type": "array", "maxItems": 10, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "reference_audios": { "type": "array", "maxItems": 10, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." } }, "required": [ "model", "prompt" ], "additionalProperties": true }, "PopGoVideoRequest14Json": { "type": "object", "properties": { "model": { "type": "string", "enum": [ "RuoX-SD2.5-S" ] }, "prompt": { "type": "string", "minLength": 1, "description": "Describe the desired scene and motion." }, "seconds": { "type": "string", "default": "5", "enum": [ "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20", "21", "22", "23", "24", "25", "26", "27", "28", "29", "30" ], "description": "Output duration in seconds; use the range or values listed here." }, "resolution": { "type": "string", "default": "480p", "enum": [ "480p", "720p", "1080p" ], "description": "Output resolution; values are case-sensitive." }, "aspect_ratio": { "type": "string", "default": "16:9", "enum": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ], "description": "Output aspect ratio." }, "reference_images": { "type": "array", "maxItems": 30, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "reference_videos": { "type": "array", "maxItems": 10, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "reference_audios": { "type": "array", "maxItems": 10, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." } }, "required": [ "model", "prompt" ], "additionalProperties": true }, "PopGoVideoRequest15Json": { "type": "object", "properties": { "model": { "type": "string", "enum": [ "RuoX-wan3" ] }, "prompt": { "type": "string", "minLength": 1, "description": "Describe the desired scene and motion." }, "seconds": { "type": "string", "default": "10", "enum": [ "2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20", "21", "22", "23", "24", "25", "26", "27", "28", "29", "30" ], "description": "Output duration in seconds; use the range or values listed here." }, "resolution": { "type": "string", "default": "720p", "enum": [ "720p", "1080p" ], "description": "Output resolution; values are case-sensitive." }, "aspect_ratio": { "type": "string", "default": "16:9", "enum": [ "1:1", "4:3", "16:9", "9:16" ], "description": "Output aspect ratio." }, "input_reference": { "type": "object", "additionalProperties": false, "properties": { "image_url": { "type": "string", "format": "uri", "pattern": "^https://" } }, "required": [ "image_url" ], "description": "One first-frame image as an object: image_url is a publicly downloadable HTTPS URL." }, "reference_images": { "type": "array", "maxItems": 10, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "reference_videos": { "type": "array", "maxItems": 5, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "reference_audios": { "type": "array", "maxItems": 5, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "first_frame": { "type": "string", "format": "uri", "pattern": "^https://", "description": "First-frame image as a publicly downloadable HTTPS URL; follow this model’s frame-combination rules." }, "last_frame": { "type": "string", "format": "uri", "pattern": "^https://", "description": "Last-frame image as a publicly downloadable HTTPS URL; follow this model’s frame-combination rules." } }, "required": [ "model", "prompt" ], "additionalProperties": true }, "PopGoVideoRequest16Json": { "type": "object", "properties": { "model": { "type": "string", "enum": [ "RuoX-wan3-Prime" ] }, "prompt": { "type": "string", "minLength": 1, "description": "Describe the desired scene and motion." }, "seconds": { "type": "string", "default": "10", "enum": [ "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20", "21", "22", "23", "24", "25", "26", "27", "28", "29", "30" ], "description": "Output duration in seconds; use the range or values listed here." }, "resolution": { "type": "string", "default": "720p", "enum": [ "720p", "1080p" ], "description": "Output resolution; values are case-sensitive." }, "aspect_ratio": { "type": "string", "default": "16:9", "enum": [ "1:1", "4:3", "16:9", "9:16" ], "description": "Output aspect ratio." }, "reference_images": { "type": "array", "maxItems": 10, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "reference_videos": { "type": "array", "maxItems": 5, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "reference_audios": { "type": "array", "maxItems": 5, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." } }, "required": [ "model", "prompt" ], "additionalProperties": true }, "PopGoVideoRequest17Json": { "type": "object", "properties": { "model": { "type": "string", "enum": [ "RuoX-wan3-smart" ] }, "prompt": { "type": "string", "minLength": 1, "description": "Describe the desired scene and motion." }, "seconds": { "type": "string", "default": "5", "enum": [ "2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20", "21", "22", "23", "24", "25", "26", "27", "28", "29", "30" ], "description": "Output duration in seconds; use the range or values listed here." }, "resolution": { "type": "string", "default": "720P", "enum": [ "480P", "720P", "1080P" ], "description": "Output resolution; values are case-sensitive." }, "aspect_ratio": { "type": "string", "default": "16:9", "enum": [ "adaptive", "16:9", "4:3", "1:1", "3:4", "9:16" ], "description": "Output aspect ratio." }, "audio": { "type": "boolean", "description": "Whether to generate an output audio track. Explicit false is supported." }, "prompt_extend": { "type": "boolean", "description": "Whether to expand the prompt." }, "watermark": { "type": "boolean", "description": "Whether to add a watermark." }, "reference_images": { "type": "array", "maxItems": 10, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "reference_videos": { "type": "array", "maxItems": 5, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "reference_audios": { "type": "array", "maxItems": 5, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." } }, "required": [ "model", "prompt" ], "additionalProperties": true }, "PopGoVideoRequest18Json": { "type": "object", "properties": { "model": { "type": "string", "enum": [ "seedance2.0-A" ] }, "prompt": { "type": "string", "minLength": 1, "description": "Describe the desired scene and motion." }, "seconds": { "type": "string", "default": "4", "enum": [ "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15" ], "description": "Output duration in seconds; use the range or values listed here." }, "resolution": { "type": "string", "enum": [ "480p", "720p", "1080p" ], "description": "Output resolution; values are case-sensitive." }, "aspect_ratio": { "type": "string", "enum": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9", "auto" ], "description": "Output aspect ratio." }, "reference_images": { "type": "array", "maxItems": 9, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "reference_videos": { "type": "array", "maxItems": 3, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "reference_audios": { "type": "array", "maxItems": 3, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "first_frame": { "type": "string", "format": "uri", "pattern": "^https://", "description": "First-frame image as a publicly downloadable HTTPS URL; follow this model’s frame-combination rules." }, "last_frame": { "type": "string", "format": "uri", "pattern": "^https://", "description": "Last-frame image as a publicly downloadable HTTPS URL; follow this model’s frame-combination rules." } }, "required": [ "model", "prompt" ], "additionalProperties": true }, "PopGoVideoRequest19Json": { "type": "object", "properties": { "model": { "type": "string", "enum": [ "seedance2.5-A" ] }, "prompt": { "type": "string", "minLength": 1, "description": "Describe the desired scene and motion." }, "seconds": { "type": "string", "default": "4", "enum": [ "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20", "21", "22", "23", "24", "25", "26", "27", "28", "29", "30" ], "description": "Output duration in seconds; use the range or values listed here." }, "resolution": { "type": "string", "enum": [ "480p", "720p" ], "description": "Output resolution; values are case-sensitive." }, "aspect_ratio": { "type": "string", "enum": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ], "description": "Output aspect ratio." }, "reference_images": { "type": "array", "maxItems": 30, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "reference_videos": { "type": "array", "maxItems": 10, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "reference_audios": { "type": "array", "maxItems": 10, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." } }, "required": [ "model", "prompt" ], "additionalProperties": true }, "PopGoVideoRequest20Json": { "type": "object", "properties": { "model": { "type": "string", "enum": [ "CAT-SD2.0-903" ] }, "prompt": { "type": "string", "minLength": 1, "description": "Describe the desired scene and motion." }, "seconds": { "type": "string", "default": "4", "enum": [ "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15" ], "description": "Output duration in seconds; use the range or values listed here." }, "resolution": { "type": "string", "default": "720p", "enum": [ "720p" ], "description": "Output resolution; values are case-sensitive." }, "aspect_ratio": { "type": "string", "default": "16:9", "enum": [ "16:9", "9:16", "4:3", "1:1", "3:4" ], "description": "Output aspect ratio." }, "reference_images": { "type": "array", "maxItems": 9, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "reference_audios": { "type": "array", "maxItems": 3, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." } }, "required": [ "model", "prompt" ], "additionalProperties": true }, "PopGoVideoRequest21Json": { "type": "object", "properties": { "model": { "type": "string", "enum": [ "TX-SD2.0" ] }, "prompt": { "type": "string", "minLength": 1, "description": "Describe the desired scene and motion." }, "seconds": { "type": "string", "default": "5", "enum": [ "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15" ], "description": "Output duration in seconds; use the range or values listed here." }, "resolution": { "type": "string", "default": "720p", "enum": [ "480p", "720p" ], "description": "Output resolution; values are case-sensitive." }, "aspect_ratio": { "type": "string", "default": "16:9", "enum": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ], "description": "Output aspect ratio." }, "generate_audio": { "type": "boolean", "default": true, "description": "Whether to generate an output audio track. Explicit false is supported." }, "reference_images": { "type": "array", "maxItems": 9, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "reference_videos": { "type": "array", "maxItems": 3, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "first_frame": { "type": "string", "format": "uri", "pattern": "^https://", "description": "First-frame image as a publicly downloadable HTTPS URL; follow this model’s frame-combination rules." }, "last_frame": { "type": "string", "format": "uri", "pattern": "^https://", "description": "Last-frame image as a publicly downloadable HTTPS URL; follow this model’s frame-combination rules." } }, "required": [ "model", "prompt" ], "additionalProperties": true }, "PopGoVideoRequest22Json": { "type": "object", "properties": { "model": { "type": "string", "enum": [ "TX-SD2.5" ] }, "prompt": { "type": "string", "minLength": 1, "description": "Describe the desired scene and motion." }, "seconds": { "type": "string", "default": "5", "enum": [ "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20", "21", "22", "23", "24", "25", "26", "27", "28", "29", "30" ], "description": "Output duration in seconds; use the range or values listed here." }, "resolution": { "type": "string", "default": "1080p", "enum": [ "480p", "720p", "1080p" ], "description": "Output resolution; values are case-sensitive." }, "aspect_ratio": { "type": "string", "default": "16:9", "enum": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ], "description": "Output aspect ratio." }, "generate_audio": { "type": "boolean", "default": true, "description": "Whether to generate an output audio track. Explicit false is supported." }, "reference_images": { "type": "array", "maxItems": 30, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "reference_videos": { "type": "array", "maxItems": 10, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "reference_audios": { "type": "array", "maxItems": 10, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "first_frame": { "type": "string", "format": "uri", "pattern": "^https://", "description": "First-frame image as a publicly downloadable HTTPS URL; follow this model’s frame-combination rules." }, "last_frame": { "type": "string", "format": "uri", "pattern": "^https://", "description": "Last-frame image as a publicly downloadable HTTPS URL; follow this model’s frame-combination rules." } }, "required": [ "model", "prompt" ], "additionalProperties": true }, "PopGoVideoRequest23Json": { "type": "object", "properties": { "model": { "type": "string", "enum": [ "XING-SD2.0-933" ] }, "prompt": { "type": "string", "minLength": 1, "maxLength": 15000, "description": "Describe the desired scene and motion." }, "seconds": { "type": "string", "default": "5", "enum": [ "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15" ], "description": "Output duration in seconds; use the range or values listed here." }, "resolution": { "type": "string", "default": "720p", "enum": [ "720p" ], "description": "Output resolution; values are case-sensitive." }, "reference_images": { "type": "array", "maxItems": 9, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "reference_videos": { "type": "array", "maxItems": 3, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "reference_audios": { "type": "array", "maxItems": 3, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." } }, "required": [ "model", "prompt" ], "additionalProperties": true }, "PopGoVideoRequest24Json": { "type": "object", "properties": { "model": { "type": "string", "enum": [ "doubao-seedance-2-0-260128" ] }, "prompt": { "type": "string", "minLength": 1, "description": "Describe the desired scene and motion." }, "seconds": { "type": "string", "default": "4", "enum": [ "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15" ], "description": "Output duration in seconds; use the range or values listed here." }, "resolution": { "type": "string", "default": "480p", "enum": [ "480p", "720p", "1080p", "4k" ], "description": "Output resolution; values are case-sensitive." }, "aspect_ratio": { "type": "string", "default": "adaptive", "enum": [ "adaptive", "16:9", "4:3", "1:1", "3:4", "9:16", "21:9" ], "description": "Output aspect ratio." }, "reference_images": { "type": "array", "maxItems": 9, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "reference_videos": { "type": "array", "maxItems": 3, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "reference_audios": { "type": "array", "maxItems": 3, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "first_frame": { "type": "string", "format": "uri", "pattern": "^https://", "description": "First-frame image as a publicly downloadable HTTPS URL; follow this model’s frame-combination rules." }, "last_frame": { "type": "string", "format": "uri", "pattern": "^https://", "description": "Last-frame image as a publicly downloadable HTTPS URL; follow this model’s frame-combination rules." } }, "required": [ "model", "prompt" ], "additionalProperties": true }, "PopGoVideoRequest25Json": { "type": "object", "properties": { "model": { "type": "string", "enum": [ "doubao-seedance-2-0-fast-260128" ] }, "prompt": { "type": "string", "minLength": 1, "description": "Describe the desired scene and motion." }, "seconds": { "type": "string", "default": "4", "enum": [ "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15" ], "description": "Output duration in seconds; use the range or values listed here." }, "resolution": { "type": "string", "default": "480p", "enum": [ "480p", "720p" ], "description": "Output resolution; values are case-sensitive." }, "aspect_ratio": { "type": "string", "default": "adaptive", "enum": [ "adaptive", "16:9", "4:3", "1:1", "3:4", "9:16", "21:9" ], "description": "Output aspect ratio." }, "reference_images": { "type": "array", "maxItems": 9, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "reference_videos": { "type": "array", "maxItems": 3, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "reference_audios": { "type": "array", "maxItems": 3, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "first_frame": { "type": "string", "format": "uri", "pattern": "^https://", "description": "First-frame image as a publicly downloadable HTTPS URL; follow this model’s frame-combination rules." }, "last_frame": { "type": "string", "format": "uri", "pattern": "^https://", "description": "Last-frame image as a publicly downloadable HTTPS URL; follow this model’s frame-combination rules." } }, "required": [ "model", "prompt" ], "additionalProperties": true }, "PopGoVideoRequest26Json": { "type": "object", "properties": { "model": { "type": "string", "enum": [ "doubao-seedance-2-0-mini-260615" ] }, "prompt": { "type": "string", "minLength": 1, "description": "Describe the desired scene and motion." }, "seconds": { "type": "string", "default": "4", "enum": [ "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15" ], "description": "Output duration in seconds; use the range or values listed here." }, "resolution": { "type": "string", "default": "480p", "enum": [ "480p", "720p" ], "description": "Output resolution; values are case-sensitive." }, "aspect_ratio": { "type": "string", "default": "adaptive", "enum": [ "adaptive", "16:9", "4:3", "1:1", "3:4", "9:16", "21:9" ], "description": "Output aspect ratio." }, "reference_images": { "type": "array", "maxItems": 9, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "reference_videos": { "type": "array", "maxItems": 3, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "reference_audios": { "type": "array", "maxItems": 3, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "first_frame": { "type": "string", "format": "uri", "pattern": "^https://", "description": "First-frame image as a publicly downloadable HTTPS URL; follow this model’s frame-combination rules." }, "last_frame": { "type": "string", "format": "uri", "pattern": "^https://", "description": "Last-frame image as a publicly downloadable HTTPS URL; follow this model’s frame-combination rules." } }, "required": [ "model", "prompt" ], "additionalProperties": true }, "PopGoVideoRequest27Json": { "type": "object", "properties": { "model": { "type": "string", "enum": [ "doubao-seedance-2-5-260628" ] }, "prompt": { "type": "string", "minLength": 1, "description": "Describe the desired scene and motion." }, "seconds": { "type": "string", "default": "4", "enum": [ "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20", "21", "22", "23", "24", "25", "26", "27", "28", "29", "30" ], "description": "Output duration in seconds; use the range or values listed here." }, "resolution": { "type": "string", "default": "480p", "enum": [ "480p", "720p", "1080p" ], "description": "Output resolution; values are case-sensitive." }, "aspect_ratio": { "type": "string", "default": "adaptive", "enum": [ "adaptive", "16:9", "4:3", "1:1", "3:4", "9:16", "21:9" ], "description": "Output aspect ratio." }, "reference_images": { "type": "array", "maxItems": 30, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "reference_videos": { "type": "array", "maxItems": 10, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "reference_audios": { "type": "array", "maxItems": 10, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "first_frame": { "type": "string", "format": "uri", "pattern": "^https://", "description": "First-frame image as a publicly downloadable HTTPS URL; follow this model’s frame-combination rules." }, "last_frame": { "type": "string", "format": "uri", "pattern": "^https://", "description": "Last-frame image as a publicly downloadable HTTPS URL; follow this model’s frame-combination rules." } }, "required": [ "model", "prompt" ], "additionalProperties": true }, "PopGoVideoRequest28Json": { "type": "object", "properties": { "model": { "type": "string", "enum": [ "video-ultra-720p" ] }, "prompt": { "type": "string", "minLength": 1, "description": "Describe the desired scene and motion." }, "seconds": { "type": "string", "default": "4", "enum": [ "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15" ], "description": "Output duration in seconds; use the range or values listed here." }, "resolution": { "type": "string", "default": "720p", "enum": [ "720p" ], "description": "Output resolution; values are case-sensitive." }, "aspect_ratio": { "type": "string", "default": "adaptive", "enum": [ "adaptive", "16:9", "4:3", "1:1", "3:4", "9:16", "21:9" ], "description": "Output aspect ratio." }, "reference_images": { "type": "array", "maxItems": 9, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "reference_audios": { "type": "array", "maxItems": 3, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "first_frame": { "type": "string", "format": "uri", "pattern": "^https://", "description": "First-frame image as a publicly downloadable HTTPS URL; follow this model’s frame-combination rules." }, "last_frame": { "type": "string", "format": "uri", "pattern": "^https://", "description": "Last-frame image as a publicly downloadable HTTPS URL; follow this model’s frame-combination rules." } }, "required": [ "model", "prompt" ], "additionalProperties": true }, "PopGoVideoRequest29Json": { "type": "object", "properties": { "model": { "type": "string", "enum": [ "video-ultra-720p-fast" ] }, "prompt": { "type": "string", "minLength": 1, "description": "Describe the desired scene and motion." }, "seconds": { "type": "string", "default": "4", "enum": [ "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15" ], "description": "Output duration in seconds; use the range or values listed here." }, "resolution": { "type": "string", "default": "720p", "enum": [ "720p" ], "description": "Output resolution; values are case-sensitive." }, "aspect_ratio": { "type": "string", "default": "adaptive", "enum": [ "adaptive", "16:9", "4:3", "1:1", "3:4", "9:16", "21:9" ], "description": "Output aspect ratio." }, "reference_images": { "type": "array", "maxItems": 9, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "reference_audios": { "type": "array", "maxItems": 3, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "first_frame": { "type": "string", "format": "uri", "pattern": "^https://", "description": "First-frame image as a publicly downloadable HTTPS URL; follow this model’s frame-combination rules." }, "last_frame": { "type": "string", "format": "uri", "pattern": "^https://", "description": "Last-frame image as a publicly downloadable HTTPS URL; follow this model’s frame-combination rules." } }, "required": [ "model", "prompt" ], "additionalProperties": true }, "PopGoVideoRequest30Json": { "type": "object", "properties": { "model": { "type": "string", "enum": [ "video-ultra-720p-mini" ] }, "prompt": { "type": "string", "minLength": 1, "description": "Describe the desired scene and motion." }, "seconds": { "type": "string", "default": "4", "enum": [ "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15" ], "description": "Output duration in seconds; use the range or values listed here." }, "resolution": { "type": "string", "default": "720p", "enum": [ "720p" ], "description": "Output resolution; values are case-sensitive." }, "aspect_ratio": { "type": "string", "default": "adaptive", "enum": [ "adaptive", "16:9", "4:3", "1:1", "3:4", "9:16", "21:9" ], "description": "Output aspect ratio." }, "reference_images": { "type": "array", "maxItems": 9, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "reference_audios": { "type": "array", "maxItems": 3, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "first_frame": { "type": "string", "format": "uri", "pattern": "^https://", "description": "First-frame image as a publicly downloadable HTTPS URL; follow this model’s frame-combination rules." }, "last_frame": { "type": "string", "format": "uri", "pattern": "^https://", "description": "Last-frame image as a publicly downloadable HTTPS URL; follow this model’s frame-combination rules." } }, "required": [ "model", "prompt" ], "additionalProperties": true }, "PopGoVideoRequest31Json": { "type": "object", "properties": { "model": { "type": "string", "enum": [ "video-ultra2.5-720p" ] }, "prompt": { "type": "string", "minLength": 1, "description": "Describe the desired scene and motion." }, "seconds": { "type": "string", "default": "4", "enum": [ "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20", "21", "22", "23", "24", "25", "26", "27", "28", "29", "30" ], "description": "Output duration in seconds; use the range or values listed here." }, "resolution": { "type": "string", "default": "720p", "enum": [ "720p" ], "description": "Output resolution; values are case-sensitive." }, "aspect_ratio": { "type": "string", "default": "adaptive", "enum": [ "adaptive", "16:9", "4:3", "1:1", "3:4", "9:16", "21:9" ], "description": "Output aspect ratio." }, "reference_images": { "type": "array", "maxItems": 30, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "reference_audios": { "type": "array", "maxItems": 10, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "first_frame": { "type": "string", "format": "uri", "pattern": "^https://", "description": "First-frame image as a publicly downloadable HTTPS URL; follow this model’s frame-combination rules." }, "last_frame": { "type": "string", "format": "uri", "pattern": "^https://", "description": "Last-frame image as a publicly downloadable HTTPS URL; follow this model’s frame-combination rules." } }, "required": [ "model", "prompt" ], "additionalProperties": true }, "PopGoVideoRequest32Json": { "type": "object", "properties": { "model": { "type": "string", "enum": [ "VinH3" ] }, "prompt": { "type": "string", "minLength": 1, "maxLength": 6000, "description": "Describe the desired scene and motion." }, "seconds": { "type": "string", "default": "4", "enum": [ "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15" ], "description": "Output duration in seconds; use the range or values listed here." }, "resolution": { "type": "string", "default": "768p", "enum": [ "768p", "2k" ], "description": "Output resolution; values are case-sensitive." }, "aspect_ratio": { "type": "string", "default": "16:9", "enum": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9", "adaptive" ], "description": "Output aspect ratio." }, "input_reference": { "type": "object", "additionalProperties": false, "properties": { "image_url": { "type": "string", "format": "uri", "pattern": "^https://" } }, "required": [ "image_url" ], "description": "One first-frame image as an object: image_url is a publicly downloadable HTTPS URL." }, "reference_images": { "type": "array", "maxItems": 9, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "reference_videos": { "type": "array", "maxItems": 3, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "reference_audios": { "type": "array", "maxItems": 3, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "first_frame": { "type": "string", "format": "uri", "pattern": "^https://", "description": "First-frame image as a publicly downloadable HTTPS URL; follow this model’s frame-combination rules." }, "last_frame": { "type": "string", "format": "uri", "pattern": "^https://", "description": "Last-frame image as a publicly downloadable HTTPS URL; follow this model’s frame-combination rules." } }, "required": [ "model", "prompt" ], "additionalProperties": true }, "PopGoVideoRequest33Json": { "type": "object", "properties": { "model": { "type": "string", "enum": [ "VinSeedance-2.0" ] }, "prompt": { "type": "string", "minLength": 1, "maxLength": 15000, "description": "Describe the desired scene and motion." }, "seconds": { "type": "string", "default": "5", "enum": [ "5", "10", "15" ], "description": "Output duration in seconds; use the range or values listed here." }, "resolution": { "type": "string", "enum": [ "720p" ], "description": "Output resolution; values are case-sensitive." }, "aspect_ratio": { "type": "string", "enum": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ], "description": "Output aspect ratio." }, "camera_movement": { "type": "string", "enum": [ "auto", "fixed" ], "description": "Camera motion: auto or fixed." }, "native_face": { "type": "boolean", "description": "Face handling; true requires an image or video reference." }, "reference_images": { "type": "array", "maxItems": 9, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "reference_videos": { "type": "array", "maxItems": 3, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "reference_audios": { "type": "array", "maxItems": 3, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." } }, "required": [ "model", "prompt" ], "additionalProperties": true }, "PopGoVideoRequest34Json": { "type": "object", "properties": { "model": { "type": "string", "enum": [ "VinSeedance-2.5" ] }, "prompt": { "type": "string", "minLength": 1, "maxLength": 15000, "description": "Describe the desired scene and motion." }, "seconds": { "type": "string", "enum": [ "15", "16", "17", "18", "19", "20", "21", "22", "23", "24", "25", "26", "27", "28", "29", "30" ], "description": "Output duration in seconds; use the range or values listed here." }, "resolution": { "type": "string", "enum": [ "720p" ], "description": "Output resolution; values are case-sensitive." }, "aspect_ratio": { "type": "string", "enum": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ], "description": "Output aspect ratio." }, "camera_movement": { "type": "string", "enum": [ "auto", "fixed" ], "description": "Camera motion: auto or fixed." }, "reference_images": { "type": "array", "maxItems": 30, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "reference_videos": { "type": "array", "maxItems": 10, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "reference_audios": { "type": "array", "maxItems": 10, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." } }, "required": [ "model", "prompt", "seconds" ], "additionalProperties": true }, "PopGoVideoRequest35Json": { "type": "object", "properties": { "model": { "type": "string", "enum": [ "YUXI-H3-PRO" ] }, "prompt": { "type": "string", "minLength": 1, "description": "Describe the desired scene and motion." }, "seconds": { "type": "string", "default": "5", "enum": [ "1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15" ], "description": "Output duration in seconds; use the range or values listed here." }, "resolution": { "type": "string", "default": "768p", "enum": [ "480p", "768p" ], "description": "Output resolution; values are case-sensitive." }, "aspect_ratio": { "type": "string", "default": "16:9", "enum": [ "16:9", "9:16", "1:1" ], "description": "Output aspect ratio." }, "reference_images": { "type": "array", "maxItems": 9, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "reference_audios": { "type": "array", "maxItems": 3, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." } }, "required": [ "model", "prompt" ], "additionalProperties": true }, "PopGoVideoRequest36Json": { "type": "object", "properties": { "model": { "type": "string", "enum": [ "YUXI-SD2.0-A" ] }, "prompt": { "type": "string", "minLength": 1, "description": "Describe the desired scene and motion." }, "seconds": { "type": "string", "default": "15", "enum": [ "5", "10", "15" ], "description": "Output duration in seconds; use the range or values listed here." }, "resolution": { "type": "string", "default": "720p", "enum": [ "720p" ], "description": "Output resolution; values are case-sensitive." }, "aspect_ratio": { "type": "string", "default": "16:9", "enum": [ "adaptive", "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ], "description": "Output aspect ratio." }, "reference_images": { "type": "array", "maxItems": 9, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "reference_videos": { "type": "array", "maxItems": 3, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "reference_audios": { "type": "array", "maxItems": 3, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." } }, "required": [ "model", "prompt" ], "additionalProperties": true }, "PopGoVideoRequest37Json": { "type": "object", "properties": { "model": { "type": "string", "enum": [ "YUXI-SD2.5-C" ] }, "prompt": { "type": "string", "minLength": 1, "description": "Describe the desired scene and motion." }, "seconds": { "type": "string", "default": "30", "enum": [ "30" ], "description": "Output duration in seconds; use the range or values listed here." }, "resolution": { "type": "string", "default": "720p", "enum": [ "720p" ], "description": "Output resolution; values are case-sensitive." }, "aspect_ratio": { "type": "string", "default": "16:9", "enum": [ "adaptive", "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ], "description": "Output aspect ratio." }, "reference_images": { "type": "array", "maxItems": 30, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "reference_videos": { "type": "array", "maxItems": 10, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "reference_audios": { "type": "array", "maxItems": 10, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." } }, "required": [ "model", "prompt", "seconds" ], "additionalProperties": true }, "PopGoVideoRequest38Json": { "type": "object", "properties": { "model": { "type": "string", "enum": [ "NSFW-seedance2.0" ] }, "prompt": { "type": "string", "minLength": 1, "description": "Describe the desired scene and motion." }, "seconds": { "type": "string", "enum": [ "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15" ], "description": "Output duration in seconds; use the range or values listed here." }, "resolution": { "type": "string", "enum": [ "480p", "720p", "1080p", "4k" ], "description": "Output resolution; values are case-sensitive." }, "aspect_ratio": { "type": "string", "enum": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ], "description": "Output aspect ratio." }, "generate_audio": { "type": "boolean", "description": "Whether to generate an output audio track. Explicit false is supported." }, "watermark": { "type": "boolean", "description": "Whether to add a watermark." }, "reference_images": { "type": "array", "maxItems": 9, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "reference_videos": { "type": "array", "maxItems": 3, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "reference_audios": { "type": "array", "maxItems": 3, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." } }, "required": [ "model", "prompt", "seconds", "resolution", "aspect_ratio" ], "additionalProperties": true }, "PopGoVideoRequest39Json": { "type": "object", "properties": { "model": { "type": "string", "enum": [ "NSFW-seedance2.0-fast" ] }, "prompt": { "type": "string", "minLength": 1, "description": "Describe the desired scene and motion." }, "seconds": { "type": "string", "enum": [ "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15" ], "description": "Output duration in seconds; use the range or values listed here." }, "resolution": { "type": "string", "enum": [ "480p", "720p" ], "description": "Output resolution; values are case-sensitive." }, "aspect_ratio": { "type": "string", "enum": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ], "description": "Output aspect ratio." }, "generate_audio": { "type": "boolean", "description": "Whether to generate an output audio track. Explicit false is supported." }, "watermark": { "type": "boolean", "description": "Whether to add a watermark." }, "reference_images": { "type": "array", "maxItems": 9, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "reference_videos": { "type": "array", "maxItems": 3, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "reference_audios": { "type": "array", "maxItems": 3, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." } }, "required": [ "model", "prompt", "seconds", "resolution", "aspect_ratio" ], "additionalProperties": true }, "PopGoVideoRequest40Json": { "type": "object", "properties": { "model": { "type": "string", "enum": [ "NSFW-seedance2.0-mini" ] }, "prompt": { "type": "string", "minLength": 1, "description": "Describe the desired scene and motion." }, "seconds": { "type": "string", "enum": [ "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15" ], "description": "Output duration in seconds; use the range or values listed here." }, "resolution": { "type": "string", "enum": [ "480p", "720p" ], "description": "Output resolution; values are case-sensitive." }, "aspect_ratio": { "type": "string", "enum": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ], "description": "Output aspect ratio." }, "generate_audio": { "type": "boolean", "description": "Whether to generate an output audio track. Explicit false is supported." }, "watermark": { "type": "boolean", "description": "Whether to add a watermark." }, "reference_images": { "type": "array", "maxItems": 9, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "reference_videos": { "type": "array", "maxItems": 3, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "reference_audios": { "type": "array", "maxItems": 3, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." } }, "required": [ "model", "prompt", "seconds", "resolution", "aspect_ratio" ], "additionalProperties": true }, "PopGoVideoRequest41Json": { "type": "object", "properties": { "model": { "type": "string", "enum": [ "NSFW-seedance2.5" ] }, "prompt": { "type": "string", "minLength": 1, "description": "Describe the desired scene and motion." }, "seconds": { "type": "string", "enum": [ "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20", "21", "22", "23", "24", "25", "26", "27", "28", "29", "30" ], "description": "Output duration in seconds; use the range or values listed here." }, "resolution": { "type": "string", "enum": [ "480p", "720p", "1080p" ], "description": "Output resolution; values are case-sensitive." }, "aspect_ratio": { "type": "string", "enum": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ], "description": "Output aspect ratio." }, "generate_audio": { "type": "boolean", "description": "Whether to generate an output audio track. Explicit false is supported." }, "watermark": { "type": "boolean", "description": "Whether to add a watermark." }, "reference_images": { "type": "array", "maxItems": 30, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "reference_videos": { "type": "array", "maxItems": 10, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "reference_audios": { "type": "array", "maxItems": 10, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." } }, "required": [ "model", "prompt", "seconds", "resolution", "aspect_ratio" ], "additionalProperties": true }, "PopGoVideoRequest42Json": { "type": "object", "properties": { "model": { "type": "string", "enum": [ "ZHKJ-SD2.0-903" ] }, "prompt": { "type": "string", "minLength": 1, "description": "Describe the desired scene and motion." }, "seconds": { "type": "string", "enum": [ "15" ], "description": "Output duration in seconds; use the range or values listed here." }, "resolution": { "type": "string", "enum": [ "720p" ], "description": "Output resolution; values are case-sensitive." }, "aspect_ratio": { "type": "string", "enum": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ], "description": "Output aspect ratio." }, "reference_images": { "type": "array", "maxItems": 9, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "reference_audios": { "type": "array", "maxItems": 3, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." } }, "required": [ "model", "prompt", "seconds" ], "additionalProperties": true }, "PopGoVideoRequest43Json": { "type": "object", "properties": { "model": { "type": "string", "enum": [ "ZHKJ-SD2.0-G" ] }, "prompt": { "type": "string", "minLength": 1, "description": "Describe the desired scene and motion." }, "seconds": { "type": "string", "enum": [ "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15" ], "description": "Output duration in seconds; use the range or values listed here." }, "resolution": { "type": "string", "enum": [ "720p" ], "description": "Output resolution; values are case-sensitive." }, "aspect_ratio": { "type": "string", "enum": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ], "description": "Output aspect ratio." }, "reference_images": { "type": "array", "maxItems": 9, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "reference_audios": { "type": "array", "maxItems": 3, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." } }, "required": [ "model", "prompt", "seconds" ], "additionalProperties": true }, "PopGoVideoRequest44Json": { "type": "object", "properties": { "model": { "type": "string", "enum": [ "ZHKJ-SD2.0-K" ] }, "prompt": { "type": "string", "minLength": 1, "description": "Describe the desired scene and motion." }, "seconds": { "type": "string", "enum": [ "5", "10", "15" ], "description": "Output duration in seconds; use the range or values listed here." }, "resolution": { "type": "string", "enum": [ "720p" ], "description": "Output resolution; values are case-sensitive." }, "aspect_ratio": { "type": "string", "enum": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ], "description": "Output aspect ratio." }, "reference_images": { "type": "array", "maxItems": 9, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "reference_videos": { "type": "array", "maxItems": 3, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "reference_audios": { "type": "array", "maxItems": 3, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." } }, "required": [ "model", "prompt", "seconds" ], "additionalProperties": true }, "PopGoVideoRequest45Json": { "type": "object", "properties": { "model": { "type": "string", "enum": [ "ZHKJ-SD2.0-S" ] }, "prompt": { "type": "string", "minLength": 1, "description": "Describe the desired scene and motion." }, "seconds": { "type": "string", "enum": [ "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15" ], "description": "Output duration in seconds; use the range or values listed here." }, "resolution": { "type": "string", "enum": [ "720p" ], "description": "Output resolution; values are case-sensitive." }, "aspect_ratio": { "type": "string", "enum": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ], "description": "Output aspect ratio." }, "reference_images": { "type": "array", "maxItems": 9, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "reference_videos": { "type": "array", "maxItems": 3, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "reference_audios": { "type": "array", "maxItems": 3, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." } }, "required": [ "model", "prompt", "seconds" ], "additionalProperties": true }, "PopGoVideoRequest46Json": { "type": "object", "properties": { "model": { "type": "string", "enum": [ "ZHKJ-SD2.5-K" ] }, "prompt": { "type": "string", "minLength": 1, "description": "Describe the desired scene and motion." }, "seconds": { "type": "string", "enum": [ "10", "15", "20", "25", "30" ], "description": "Output duration in seconds; use the range or values listed here." }, "resolution": { "type": "string", "enum": [ "720p" ], "description": "Output resolution; values are case-sensitive." }, "aspect_ratio": { "type": "string", "enum": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ], "description": "Output aspect ratio." }, "reference_images": { "type": "array", "maxItems": 9, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." } }, "required": [ "model", "prompt", "seconds" ], "additionalProperties": true }, "PopGoVideoRequest47Json": { "type": "object", "properties": { "model": { "type": "string", "enum": [ "ZHKJ-SD2.5-S" ] }, "prompt": { "type": "string", "minLength": 1, "description": "Describe the desired scene and motion." }, "seconds": { "type": "string", "enum": [ "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20", "21", "22", "23", "24", "25", "26", "27", "28", "29", "30" ], "description": "Output duration in seconds; use the range or values listed here." }, "resolution": { "type": "string", "enum": [ "720p" ], "description": "Output resolution; values are case-sensitive." }, "aspect_ratio": { "type": "string", "enum": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ], "description": "Output aspect ratio." }, "reference_images": { "type": "array", "maxItems": 30, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "reference_videos": { "type": "array", "maxItems": 10, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "reference_audios": { "type": "array", "maxItems": 10, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." } }, "required": [ "model", "prompt", "seconds" ], "additionalProperties": true }, "PopGoVideoRequest48Json": { "type": "object", "properties": { "model": { "type": "string", "enum": [ "ZHKJ-SD2.5-A" ] }, "prompt": { "type": "string", "minLength": 1, "description": "Describe the desired scene and motion." }, "seconds": { "type": "string", "enum": [ "30" ], "description": "Output duration in seconds; use the range or values listed here." }, "resolution": { "type": "string", "enum": [ "720p" ], "description": "Output resolution; values are case-sensitive." }, "aspect_ratio": { "type": "string", "enum": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ], "description": "Output aspect ratio." }, "reference_images": { "type": "array", "maxItems": 30, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "reference_videos": { "type": "array", "maxItems": 10, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "reference_audios": { "type": "array", "maxItems": 10, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." } }, "required": [ "model", "prompt", "seconds" ], "additionalProperties": true }, "PopGoVideoRequest49Json": { "type": "object", "properties": { "model": { "type": "string", "enum": [ "ZHKJ-SD2.5-480" ] }, "prompt": { "type": "string", "minLength": 1, "description": "Describe the desired scene and motion." }, "seconds": { "type": "string", "default": "5", "enum": [ "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20", "21", "22", "23", "24", "25", "26", "27", "28", "29", "30" ], "description": "Output duration in seconds; use the range or values listed here." }, "resolution": { "type": "string", "default": "480p", "enum": [ "480p" ], "description": "Output resolution; values are case-sensitive." }, "aspect_ratio": { "type": "string", "default": "16:9", "enum": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ], "description": "Output aspect ratio." }, "reference_images": { "type": "array", "maxItems": 30, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "reference_videos": { "type": "array", "maxItems": 10, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "reference_audios": { "type": "array", "maxItems": 10, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." } }, "required": [ "model", "prompt", "seconds" ], "additionalProperties": true }, "PopGoVideoRequest50Json": { "type": "object", "properties": { "model": { "type": "string", "enum": [ "ZHKJ-SD2.5-720" ] }, "prompt": { "type": "string", "minLength": 1, "description": "Describe the desired scene and motion." }, "seconds": { "type": "string", "default": "5", "enum": [ "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20", "21", "22", "23", "24", "25", "26", "27", "28", "29", "30" ], "description": "Output duration in seconds; use the range or values listed here." }, "resolution": { "type": "string", "default": "720p", "enum": [ "720p" ], "description": "Output resolution; values are case-sensitive." }, "aspect_ratio": { "type": "string", "default": "16:9", "enum": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ], "description": "Output aspect ratio." }, "reference_images": { "type": "array", "maxItems": 30, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "reference_videos": { "type": "array", "maxItems": 10, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "reference_audios": { "type": "array", "maxItems": 10, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." } }, "required": [ "model", "prompt", "seconds" ], "additionalProperties": true }, "PopGoVideoRequest51Json": { "type": "object", "properties": { "model": { "type": "string", "enum": [ "ZHKJ-SD2.5-1080" ] }, "prompt": { "type": "string", "minLength": 1, "description": "Describe the desired scene and motion." }, "seconds": { "type": "string", "default": "5", "enum": [ "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20", "21", "22", "23", "24", "25", "26", "27", "28", "29", "30" ], "description": "Output duration in seconds; use the range or values listed here." }, "resolution": { "type": "string", "default": "1080p", "enum": [ "1080p" ], "description": "Output resolution; values are case-sensitive." }, "aspect_ratio": { "type": "string", "default": "16:9", "enum": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ], "description": "Output aspect ratio." }, "reference_images": { "type": "array", "maxItems": 30, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "reference_videos": { "type": "array", "maxItems": 10, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "reference_audios": { "type": "array", "maxItems": 10, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." } }, "required": [ "model", "prompt", "seconds" ], "additionalProperties": true }, "PopGoVideoRequest52Json": { "type": "object", "properties": { "model": { "type": "string", "enum": [ "XING-SD2.5-720" ] }, "prompt": { "type": "string", "minLength": 1, "description": "Describe the desired scene and motion." }, "seconds": { "type": "string", "default": "5", "enum": [ "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20", "21", "22", "23", "24", "25", "26", "27", "28", "29", "30" ], "description": "Output duration in seconds; use the range or values listed here." }, "resolution": { "type": "string", "default": "720p", "enum": [ "720p" ], "description": "Output resolution; values are case-sensitive." }, "aspect_ratio": { "type": "string", "default": "9:16", "enum": [ "1:1", "16:9", "9:16", "4:3", "3:4" ], "description": "Output aspect ratio." }, "reference_images": { "type": "array", "maxItems": 30, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "reference_videos": { "type": "array", "maxItems": 10, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "reference_audios": { "type": "array", "maxItems": 10, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." } }, "required": [ "model", "prompt" ], "additionalProperties": true }, "PopGoVideoRequest53Json": { "type": "object", "properties": { "model": { "type": "string", "enum": [ "YUXI-SD2.0-fast" ] }, "prompt": { "type": "string", "minLength": 1, "description": "Describe the desired scene and motion." }, "seconds": { "type": "string", "default": "15", "enum": [ "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15" ], "description": "Output duration in seconds; use the range or values listed here." }, "resolution": { "type": "string", "default": "480p", "enum": [ "480p", "720p" ], "description": "Output resolution; values are case-sensitive." }, "aspect_ratio": { "type": "string", "default": "9:16", "enum": [ "16:9", "9:16", "1:1", "4:3", "3:4" ], "description": "Output aspect ratio." }, "reference_images": { "type": "array", "maxItems": 9, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "reference_videos": { "type": "array", "maxItems": 3, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "reference_audios": { "type": "array", "maxItems": 3, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." } }, "required": [ "model", "prompt" ], "additionalProperties": true }, "PopGoVideoRequest54Json": { "type": "object", "properties": { "model": { "type": "string", "enum": [ "YUXI-SD2.0-mini" ] }, "prompt": { "type": "string", "minLength": 1, "description": "Describe the desired scene and motion." }, "seconds": { "type": "string", "default": "15", "enum": [ "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15" ], "description": "Output duration in seconds; use the range or values listed here." }, "resolution": { "type": "string", "default": "480p", "enum": [ "480p", "720p" ], "description": "Output resolution; values are case-sensitive." }, "aspect_ratio": { "type": "string", "default": "9:16", "enum": [ "16:9", "9:16", "1:1", "4:3", "3:4" ], "description": "Output aspect ratio." }, "reference_images": { "type": "array", "maxItems": 9, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "reference_videos": { "type": "array", "maxItems": 3, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "reference_audios": { "type": "array", "maxItems": 3, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." } }, "required": [ "model", "prompt" ], "additionalProperties": true }, "PopGoVideoRequest56Json": { "type": "object", "properties": { "model": { "type": "string", "enum": [ "seedance-2-0" ] }, "prompt": { "type": "string", "minLength": 1, "description": "Describe the desired scene and motion." }, "seconds": { "type": "string", "default": "4", "enum": [ "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15" ], "description": "Output duration in seconds; use the range or values listed here." }, "resolution": { "type": "string", "default": "480p", "enum": [ "480p", "720p", "1080p", "4k" ], "description": "Output resolution; values are case-sensitive." }, "aspect_ratio": { "type": "string", "default": "adaptive", "enum": [ "adaptive", "16:9", "4:3", "1:1", "3:4", "9:16", "21:9" ], "description": "Output aspect ratio." }, "reference_images": { "type": "array", "maxItems": 9, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "reference_videos": { "type": "array", "maxItems": 3, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "reference_audios": { "type": "array", "maxItems": 3, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "first_frame": { "type": "string", "format": "uri", "pattern": "^https://", "description": "First-frame image as a publicly downloadable HTTPS URL; follow this model’s frame-combination rules." }, "last_frame": { "type": "string", "format": "uri", "pattern": "^https://", "description": "Last-frame image as a publicly downloadable HTTPS URL; follow this model’s frame-combination rules." } }, "required": [ "model", "prompt" ], "additionalProperties": true }, "PopGoVideoRequest57Json": { "type": "object", "properties": { "model": { "type": "string", "enum": [ "seedance-2-0-fast" ] }, "prompt": { "type": "string", "minLength": 1, "description": "Describe the desired scene and motion." }, "seconds": { "type": "string", "default": "4", "enum": [ "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15" ], "description": "Output duration in seconds; use the range or values listed here." }, "resolution": { "type": "string", "default": "480p", "enum": [ "480p", "720p" ], "description": "Output resolution; values are case-sensitive." }, "aspect_ratio": { "type": "string", "default": "adaptive", "enum": [ "adaptive", "16:9", "4:3", "1:1", "3:4", "9:16", "21:9" ], "description": "Output aspect ratio." }, "reference_images": { "type": "array", "maxItems": 9, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "reference_videos": { "type": "array", "maxItems": 3, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "reference_audios": { "type": "array", "maxItems": 3, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "first_frame": { "type": "string", "format": "uri", "pattern": "^https://", "description": "First-frame image as a publicly downloadable HTTPS URL; follow this model’s frame-combination rules." }, "last_frame": { "type": "string", "format": "uri", "pattern": "^https://", "description": "Last-frame image as a publicly downloadable HTTPS URL; follow this model’s frame-combination rules." } }, "required": [ "model", "prompt" ], "additionalProperties": true }, "PopGoVideoRequest58Json": { "type": "object", "properties": { "model": { "type": "string", "enum": [ "seedance-2-0-mini" ] }, "prompt": { "type": "string", "minLength": 1, "description": "Describe the desired scene and motion." }, "seconds": { "type": "string", "default": "4", "enum": [ "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15" ], "description": "Output duration in seconds; use the range or values listed here." }, "resolution": { "type": "string", "default": "480p", "enum": [ "480p", "720p" ], "description": "Output resolution; values are case-sensitive." }, "aspect_ratio": { "type": "string", "default": "adaptive", "enum": [ "adaptive", "16:9", "4:3", "1:1", "3:4", "9:16", "21:9" ], "description": "Output aspect ratio." }, "reference_images": { "type": "array", "maxItems": 9, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "reference_videos": { "type": "array", "maxItems": 3, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "reference_audios": { "type": "array", "maxItems": 3, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "first_frame": { "type": "string", "format": "uri", "pattern": "^https://", "description": "First-frame image as a publicly downloadable HTTPS URL; follow this model’s frame-combination rules." }, "last_frame": { "type": "string", "format": "uri", "pattern": "^https://", "description": "Last-frame image as a publicly downloadable HTTPS URL; follow this model’s frame-combination rules." } }, "required": [ "model", "prompt" ], "additionalProperties": true }, "PopGoVideoRequest59Json": { "type": "object", "properties": { "model": { "type": "string", "enum": [ "seedance-2-5" ] }, "prompt": { "type": "string", "minLength": 1, "description": "Describe the desired scene and motion." }, "seconds": { "type": "string", "default": "4", "enum": [ "0", "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20", "21", "22", "23", "24", "25", "26", "27", "28", "29", "30" ], "description": "Ordinary generation: 4–30 seconds. Video editing: \"0\", together with mode=videoEdit2video." }, "resolution": { "type": "string", "default": "480p", "enum": [ "480p", "720p", "1080p" ], "description": "Output resolution; values are case-sensitive." }, "aspect_ratio": { "type": "string", "default": "adaptive", "enum": [ "adaptive", "16:9", "4:3", "1:1", "3:4", "9:16", "21:9" ], "description": "Output aspect ratio." }, "reference_images": { "type": "array", "maxItems": 30, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "reference_videos": { "type": "array", "maxItems": 10, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "reference_audios": { "type": "array", "maxItems": 10, "items": { "type": "string", "format": "uri", "pattern": "^https://" }, "description": "Array of publicly accessible HTTPS media URLs." }, "first_frame": { "type": "string", "format": "uri", "pattern": "^https://", "description": "First-frame image as a publicly downloadable HTTPS URL; follow this model’s frame-combination rules." }, "last_frame": { "type": "string", "format": "uri", "pattern": "^https://", "description": "Last-frame image as a publicly downloadable HTTPS URL; follow this model’s frame-combination rules." }, "mode": { "type": "string", "enum": [ "videoEdit2video" ], "description": "For seedance-2-5 video editing, set mode to videoEdit2video, seconds to \"0\" and aspect_ratio to adaptive. Provide one 4–30 second reference video; up to 30 images may be added. Omit audio references. For ordinary generation, omit mode." } }, "required": [ "model", "prompt" ], "additionalProperties": true }, "OpenAIVideo": { "type": "object", "description": "视频任务信息。任务完成后，`video_url` 和 `metadata.url`（如果返回）指向视频内容接口；使用同一 API Key 调用 `/v1/videos/{task_id}/content` 可播放或下载视频。", "properties": { "id": { "type": "string", "description": "视频 ID" }, "task_id": { "type": "string", "description": "任务 ID (兼容旧接口)", "deprecated": true }, "object": { "type": "string", "description": "对象类型" }, "model": { "type": "string", "description": "使用的模型" }, "status": { "type": "string", "description": "任务状态", "enum": [ "queued", "in_progress", "completed", "failed" ] }, "progress": { "type": "integer", "description": "进度百分比" }, "created_at": { "type": "integer", "description": "创建时间戳" }, "completed_at": { "type": "integer", "description": "完成时间戳" }, "expires_at": { "type": "integer", "description": "过期时间戳" }, "seconds": { "type": "string", "description": "视频时长" }, "video_url": { "type": "string", "format": "uri", "description": "任务完成后可能返回的视频地址；使用同一 API Key 访问。" }, "size": { "type": "string", "description": "视频尺寸" }, "remixed_from_video_id": { "type": "string", "description": "源视频 ID（如果是基于其他视频生成）" }, "error": { "$ref": "#/components/schemas/OpenAIVideoError" }, "metadata": { "type": "object", "description": "额外元数据。", "additionalProperties": true, "properties": { "url": { "type": "string", "format": "uri", "description": "视频地址；访问时需要使用创建任务的同一 API Key。" } } } }, "required": [ "id", "object", "model", "status", "progress", "created_at" ] }, "ClaudeRequest": { "type": "object", "required": [ "model", "messages", "max_tokens" ], "properties": { "model": { "type": "string" }, "messages": { "type": "array", "items": { "$ref": "#/components/schemas/ClaudeMessage" } }, "system": { "oneOf": [ { "type": "string" }, { "type": "array", "items": { "type": "object", "properties": {} } } ] }, "cache_control": { "type": "object", "properties": {} }, "inference_geo": { "type": "string" }, "max_tokens": { "type": "integer", "minimum": 1 }, "temperature": { "type": "number", "minimum": 0, "maximum": 1 }, "top_p": { "type": "number" }, "top_k": { "type": "integer" }, "stream": { "type": "boolean" }, "stop_sequences": { "type": "array", "items": { "type": "string" } }, "tools": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "description": { "type": "string" }, "input_schema": { "type": "object", "properties": {} } } } }, "tool_choice": { "oneOf": [ { "type": "object", "properties": { "type": { "type": "string", "enum": [ "auto", "any", "tool", "none" ] }, "name": { "type": "string" } } } ] }, "thinking": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "enabled", "disabled" ] }, "budget_tokens": { "type": "integer" } } }, "context_management": { "type": "object", "properties": {} }, "output_config": { "type": "object", "properties": {} }, "output_format": { "type": "object", "properties": {} }, "container": { "oneOf": [ { "type": "string" }, { "type": "object", "properties": {} } ] }, "mcp_servers": { "type": "array", "items": { "type": "object", "properties": {} } }, "metadata": { "type": "object", "properties": { "user_id": { "type": "string" } } }, "speed": { "type": "string", "enum": [ "standard", "fast" ] }, "service_tier": { "type": "string", "enum": [ "auto", "standard_only" ] } } }, "ClaudeResponse": { "type": "object", "properties": { "id": { "type": "string" }, "type": { "type": "string" }, "role": { "type": "string" }, "content": { "type": "array", "items": { "type": "object", "properties": { "type": { "type": "string" }, "text": { "type": "string" } } } }, "model": { "type": "string" }, "stop_reason": { "type": "string", "enum": [ "end_turn", "max_tokens", "stop_sequence", "tool_use" ] }, "usage": { "type": "object", "properties": { "input_tokens": { "type": "integer" }, "output_tokens": { "type": "integer" }, "cache_creation_input_tokens": { "type": "integer" }, "cache_read_input_tokens": { "type": "integer" } } } } }, "GeminiResponse": { "type": "object", "properties": { "candidates": { "type": "array", "items": { "type": "object", "properties": { "content": { "type": "object", "properties": { "role": { "type": "string" }, "parts": { "type": "array", "items": { "type": "object", "properties": {} } } } }, "finishReason": { "type": "string" }, "safetyRatings": { "type": "array", "items": { "type": "object", "properties": {} } } } } }, "usageMetadata": { "type": "object", "properties": { "promptTokenCount": { "type": "integer" }, "candidatesTokenCount": { "type": "integer" }, "totalTokenCount": { "type": "integer" } } } } }, "EmbeddingRequest": { "type": "object", "required": [ "model", "input" ], "properties": { "model": { "type": "string" }, "input": { "oneOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ], "description": "要嵌入的文本" }, "encoding_format": { "type": "string", "enum": [ "float", "base64" ], "default": "float" }, "dimensions": { "type": "integer", "description": "输出向量维度" } } }, "EmbeddingResponse": { "type": "object", "properties": { "object": { "type": "string" }, "data": { "type": "array", "items": { "type": "object", "properties": { "object": { "type": "string" }, "index": { "type": "integer" }, "embedding": { "type": "array", "items": { "type": "number" } } } } }, "model": { "type": "string" }, "usage": { "type": "object", "properties": { "prompt_tokens": { "type": "integer" }, "total_tokens": { "type": "integer" } } } } }, "CompletionRequest": { "type": "object", "required": [ "model", "prompt" ], "properties": { "model": { "type": "string" }, "prompt": { "oneOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "max_tokens": { "type": "integer" }, "temperature": { "type": "number" }, "top_p": { "type": "number" }, "n": { "type": "integer" }, "stream": { "type": "boolean" }, "stop": { "oneOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "suffix": { "type": "string" }, "echo": { "type": "boolean" } } }, "CompletionResponse": { "type": "object", "properties": { "id": { "type": "string" }, "object": { "type": "string" }, "created": { "type": "integer" }, "model": { "type": "string" }, "choices": { "type": "array", "items": { "type": "object", "properties": { "text": { "type": "string" }, "index": { "type": "integer" }, "finish_reason": { "type": "string" } } } }, "usage": { "$ref": "#/components/schemas/Usage" } } }, "AudioTranscriptionResponse": { "type": "object", "properties": { "text": { "type": "string" } } }, "SpeechRequest": { "type": "object", "required": [ "model", "input", "voice" ], "properties": { "model": { "type": "string" }, "input": { "type": "string", "description": "要转换的文本", "maxLength": 4096 }, "voice": { "type": "string", "enum": [ "alloy", "echo", "fable", "onyx", "nova", "shimmer" ] }, "response_format": { "type": "string", "enum": [ "mp3", "opus", "aac", "flac", "wav", "pcm" ], "default": "mp3" }, "speed": { "type": "number", "minimum": 0.25, "maximum": 4, "default": 1 } } }, "RerankRequest": { "type": "object", "required": [ "model", "query", "documents" ], "properties": { "model": { "type": "string" }, "query": { "type": "string", "description": "查询文本" }, "documents": { "type": "array", "items": { "oneOf": [ { "type": "string" }, { "type": "object", "properties": {} } ] }, "description": "要重排序的文档列表" }, "top_n": { "type": "integer", "description": "返回前 N 个结果" }, "return_documents": { "type": "boolean", "default": false } } }, "RerankResponse": { "type": "object", "properties": { "id": { "type": "string" }, "results": { "type": "array", "items": { "type": "object", "properties": { "index": { "type": "integer" }, "relevance_score": { "type": "number" }, "document": { "type": "object", "properties": {} } } } }, "meta": { "type": "object", "properties": {} } } }, "ModerationRequest": { "type": "object", "required": [ "input" ], "properties": { "input": { "oneOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "model": { "type": "string" } } }, "ModerationResponse": { "type": "object", "properties": { "id": { "type": "string" }, "model": { "type": "string" }, "results": { "type": "array", "items": { "type": "object", "properties": { "flagged": { "type": "boolean" }, "categories": { "type": "object", "properties": {} }, "category_scores": { "type": "object", "properties": {} } } } } } }, "Model": { "type": "object", "properties": { "id": { "type": "string", "description": "模型 ID" }, "object": { "type": "string", "description": "对象类型" }, "created": { "type": "integer", "description": "创建时间戳" }, "owned_by": { "type": "string", "description": "模型所有者" } } }, "Message": { "type": "object", "required": [ "role", "content" ], "properties": { "role": { "type": "string", "enum": [ "system", "user", "assistant", "tool", "developer" ], "description": "消息角色" }, "content": { "oneOf": [ { "type": "string" }, { "type": "array", "items": { "$ref": "#/components/schemas/MessageContent" } } ], "description": "消息内容" }, "name": { "type": "string", "description": "发送者名称" }, "tool_calls": { "type": "array", "items": { "$ref": "#/components/schemas/ToolCall" } }, "tool_call_id": { "type": "string", "description": "工具调用 ID（用于 tool 角色消息）" }, "reasoning_content": { "type": "string", "description": "推理内容" } } }, "Tool": { "type": "object", "properties": { "type": { "type": "string" }, "function": { "type": "object", "properties": { "name": { "type": "string" }, "description": { "type": "string" }, "parameters": { "type": "object", "description": "JSON Schema 格式的参数定义", "properties": {} } } } } }, "ResponseFormat": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "text", "json_object", "json_schema" ] }, "json_schema": { "type": "object", "description": "JSON Schema 定义", "properties": {} } } }, "Usage": { "type": "object", "properties": { "prompt_tokens": { "type": "integer", "description": "提示词 Token 数" }, "completion_tokens": { "type": "integer", "description": "补全 Token 数" }, "total_tokens": { "type": "integer", "description": "总 Token 数" }, "prompt_tokens_details": { "type": "object", "properties": { "cached_tokens": { "type": "integer" }, "text_tokens": { "type": "integer" }, "audio_tokens": { "type": "integer" }, "image_tokens": { "type": "integer" } } }, "completion_tokens_details": { "type": "object", "properties": { "text_tokens": { "type": "integer" }, "audio_tokens": { "type": "integer" }, "reasoning_tokens": { "type": "integer" } } } } }, "OpenAIVideoError": { "type": "object", "description": "OpenAI 视频错误信息", "properties": { "message": { "type": "string", "description": "错误信息" }, "code": { "type": "string", "description": "错误码" } } }, "ClaudeMessage": { "type": "object", "required": [ "role", "content" ], "properties": { "role": { "type": "string", "enum": [ "user", "assistant" ] }, "content": { "oneOf": [ { "type": "string" }, { "type": "array", "items": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "text", "image", "tool_use", "tool_result" ] }, "text": { "type": "string" }, "source": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "base64", "url" ] }, "media_type": { "type": "string" }, "data": { "type": "string" }, "url": { "type": "string" } } }, "id": { "type": "string" }, "name": { "type": "string" }, "input": { "type": "object", "properties": {} }, "tool_use_id": { "type": "string" }, "content": { "type": "string" } } } } ] } } }, "MessageContent": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "text", "image_url", "input_audio", "file", "video_url" ] }, "text": { "type": "string" }, "image_url": { "type": "object", "properties": { "url": { "type": "string", "description": "图片 URL 或 base64" }, "detail": { "type": "string", "enum": [ "low", "high", "auto" ] } } }, "input_audio": { "type": "object", "properties": { "data": { "type": "string", "description": "Base64 编码的音频数据" }, "format": { "type": "string", "enum": [ "wav", "mp3" ] } } }, "file": { "type": "object", "properties": { "filename": { "type": "string" }, "file_data": { "type": "string" }, "file_id": { "type": "string" } } }, "video_url": { "type": "object", "properties": { "url": { "type": "string" } } } } }, "ToolCall": { "type": "object", "properties": { "id": { "type": "string" }, "type": { "type": "string" }, "function": { "type": "object", "properties": { "name": { "type": "string" }, "arguments": { "type": "string" } } } } } }, "securitySchemes": { "BearerAuth": { "type": "http", "scheme": "bearer", "description": "Authorization: Bearer YOUR_API_KEY" } } } }