{
  "components": {
    "schemas": {
      "TaskResponse": {
        "description": "Standard async task creation response",
        "properties": {
          "code": {
            "description": "Status code returned by the service",
            "example": "success",
            "type": "string"
          },
          "data": {
            "description": "Response payload containing task details",
            "properties": {
              "task_id": {
                "description": "Identifier of the created task",
                "type": "string"
              }
            },
            "required": [
              "task_id"
            ],
            "type": "object"
          },
          "fail_code": {
            "description": "Failure code if the task submission did not succeed",
            "type": "string"
          },
          "message": {
            "description": "Additional information about the request result",
            "type": "string"
          }
        },
        "required": [
          "data",
          "code",
          "message"
        ],
        "type": "object"
      },
      "TaskStatusResponse": {
        "description": "Async task status query response",
        "example": {
          "code": "success",
          "data": {
            "fail_code": "",
            "fail_reason": "",
            "finish_time": 1763274838,
            "outputs": [
              "https://api.siray.ai/redirect/example-output"
            ],
            "progress": "100%",
            "start_time": 1763274702,
            "status": "SUCCESS",
            "submit_time": 1763274672,
            "task_id": "video_69196fafcc9c8190acccf32e9b560c3f0da8a6d1948cfaa5"
          },
          "message": ""
        },
        "properties": {
          "code": {
            "description": "Status code returned by the service",
            "example": "success",
            "type": "string"
          },
          "data": {
            "description": "Task execution details",
            "properties": {
              "fail_code": {
                "description": "Failure code if the task did not succeed",
                "type": "string"
              },
              "fail_reason": {
                "description": "Explanation of the failure if the task did not succeed",
                "type": "string"
              },
              "finish_time": {
                "description": "Unix timestamp when task processing finished",
                "format": "int64",
                "type": "integer"
              },
              "outputs": {
                "description": "URLs for generated assets",
                "items": {
                  "description": "Public URL to the generated asset",
                  "format": "uri",
                  "type": "string"
                },
                "type": "array"
              },
              "progress": {
                "description": "Human-readable task progress indicator",
                "example": "100%",
                "type": "string"
              },
              "start_time": {
                "description": "Unix timestamp when task processing began",
                "format": "int64",
                "type": "integer"
              },
              "status": {
                "description": "Current task status",
                "enum": [
                  "NOT_START",
                  "SUBMITTED",
                  "QUEUED",
                  "IN_PROGRESS",
                  "FAILURE",
                  "SUCCESS"
                ],
                "type": "string"
              },
              "submit_time": {
                "description": "Unix timestamp when the task was submitted",
                "format": "int64",
                "type": "integer"
              },
              "task_id": {
                "description": "Identifier of the task",
                "type": "string"
              }
            },
            "required": [
              "task_id",
              "status"
            ],
            "type": "object"
          },
          "message": {
            "description": "Additional information or error details",
            "type": "string"
          }
        },
        "required": [
          "code",
          "message",
          "data"
        ],
        "type": "object"
      }
    },
    "securitySchemes": {
      "bearerAuth": {
        "bearerFormat": "API Key",
        "description": "Bearer authentication using API key",
        "scheme": "bearer",
        "type": "http"
      }
    }
  },
  "info": {
    "description": "Seedream 5.0 Pro i2i Spicy by ByteDance is a image editing AI model for image editing and compositing. Its Spicy variant supports mature and boundary-pushing creative content for production workflows.",
    "summary": "API for Seedream 5.0 Pro i2i Spicy model",
    "title": "Seedream 5.0 Pro i2i Spicy API",
    "version": "1.0.0"
  },
  "openapi": "3.1.0",
  "paths": {
    "/v1/images/generations/async": {
      "post": {
        "description": "Generate an image using the Seedream 5.0 Pro i2i Spicy model",
        "operationId": "image_model-lzev2p8ixlnfkbit",
        "requestBody": {
          "content": {
            "application/json": {
              "example": {
                "images": [
                  "example_value"
                ],
                "model": "bytedance/seedream-5.0-pro-i2i-spicy",
                "output_format": "jpg",
                "prompt": "example_value",
                "size": "1024x1024"
              },
              "schema": {
                "description": "Request format for image generation models",
                "properties": {
                  "images": {
                    "description": "Array of input images, which can be data URL or image URL",
                    "items": {
                      "type": "string"
                    },
                    "maxItems": 10,
                    "minItems": 1,
                    "type": "array"
                  },
                  "model": {
                    "description": "Model name to use for the request",
                    "enum": [
                      "bytedance/seedream-5.0-pro-i2i-spicy"
                    ],
                    "type": "string"
                  },
                  "output_format": {
                    "description": "Output format for the 3D model",
                    "enum": [
                      "jpg",
                      "png"
                    ],
                    "type": "string"
                  },
                  "prompt": {
                    "description": "Text prompt for generation",
                    "type": "string"
                  },
                  "size": {
                    "description": "Fixed size",
                    "enum": [
                      "1024x1024",
                      "1152x864",
                      "864x1152",
                      "1424x800",
                      "800x1424",
                      "1248x832",
                      "832x1248",
                      "1568x672",
                      "2048x2048",
                      "2368x1776",
                      "1776x2368",
                      "2816x1584",
                      "1584x2816",
                      "2496x1664",
                      "1664x2496",
                      "3136x1344"
                    ],
                    "type": "string"
                  }
                },
                "required": [
                  "model",
                  "prompt",
                  "images",
                  "size"
                ],
                "title": "Image Generation Request",
                "type": "object"
              }
            }
          },
          "description": "Request payload",
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TaskResponse"
                }
              }
            },
            "description": "Successful response"
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "summary": "Generate image",
        "tags": [
          "Seedream 5.0 Pro i2i Spicy"
        ]
      }
    },
    "/v1/images/generations/async/{task_id}": {
      "get": {
        "description": "Query the status and result of an image generation task",
        "operationId": "query_image_task_model-lzev2p8ixlnfkbit",
        "parameters": [
          {
            "description": "Task ID returned from the image generation request",
            "in": "path",
            "name": "task_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TaskStatusResponse"
                }
              }
            },
            "description": "Task status and result"
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "summary": "Query image generation task",
        "tags": [
          "Seedream 5.0 Pro i2i Spicy"
        ]
      }
    }
  },
  "servers": [
    {
      "description": "Model Verse API Server",
      "url": "https://api.siray.ai"
    }
  ],
  "tags": [
    {
      "description": "Seedream 5.0 Pro i2i Spicy - Seedream 5.0 Pro i2i Spicy by ByteDance is a image editing AI model for image editing and compositing. Its Spicy variant supports mature and boundary-pushing creative content for production workflows.",
      "name": "Seedream 5.0 Pro i2i Spicy"
    }
  ]
}