--- name: mediaio-aigc-generate description: "Generate and edit AI images and videos with Media.io OpenAPI. Supports text-to-image, image-to-image, text-to-video, and image-to-video, plus task status and credit queries. Access top models like Imagen 4, Seedream, Kling, Vidu, Wan, and Veo 3.1 in one place." metadata: {"mediaio":{"emoji":"🎨","requires":{"env":["API_KEY"]}},"publisher":"Community Maintainer","source":"https://platform.media.io/docs/"} --- # MediaIO AIGC Generate Skill ## Overview This skill routes MediaIO OpenAPI requests based on `scripts/c_api_doc_detail.json`. It provides a single entry point, `Skill.invoke(api_name, params, api_key)`, covering credits queries, text-to-image, image-to-image, image-to-video, text-to-video, and task result lookups. ## Requirements ### Environment Variables | Variable | Required | Description | |----------|----------|-------------| | `API_KEY` | **Yes** | Media.io OpenAPI key, sent as `X-API-KEY` header. Apply at . Use a **least-privilege / test key**; do not reuse broader platform credentials. | ## Provenance and Credential Notes - Maintainer: community-maintained skill (not an official Media.io release) - Reference homepage: https://developer.media.io/ - Reference API docs: https://platform.media.io/docs/ - Target API domain used by this skill: `https://openapi.media.io` - Required credential: `API_KEY` (used as `X-API-KEY`) - Security recommendation: use a least-privilege/test key, avoid reusing broader platform credentials. - Credential loading: set `API_KEY` in your environment, or pass `api_key` explicitly to `Skill.invoke(...)`. ## API Coverage (from c_api_doc_detail.json) The current API definition includes 24 endpoints, grouped by capability: - Query APIs - `Credits` (query user credit balance) - `Task Result` (query task status/result by `task_id`) - Text To Image�?�? - `Imagen 4` - `soul_character` - Image To Image�?�? - `Nano Banana` - `Seedream 4.0` - `Nano Banana Pro` - Image To Video�?4�? - `Wan 2.6` / `Wan 2.2` / `Wan 2.5` - `Hailuo 02` / `Hailuo 2.3` - `Kling 2.1` / `Kling 2.5 Turbo` / `Kling 2.6` / `Kling 3.0` - `Vidu Q2` / `Vidu Q3` - `Google Veo 3.1` / `Google Veo 3.1 Fast` - `Motion Control Kling 2.6` - Text To Video�?�? - `Wan 2.6 (Text To Video)` - `Vidu Q3 (Text To Video)` - `Wan 2.5 (Text To Video)` ## Input and Output Format - Input: - `api_name`: API name (must exactly match the `name` field in `c_api_doc_detail.json`) - `params`: Business parameter dictionary (only include fields defined in `api_body`) - `api_key`: API key - Output: - Returns the raw API response payload (dict/json) ### Common Response Structure - Success response is typically: `{"code": 0, "msg": "", "data": {...}, "trace_id": "..."}` - Asynchronous generation APIs usually return: `data.task_id` - Final artifacts should be retrieved by polling `Task Result` ## Quick Start ### 1) Install Dependency ```bash pip install requests ``` ### 2) Initialize Skill ```python import os from scripts.skill_router import Skill skill = Skill('scripts/c_api_doc_detail.json') api_key = os.getenv('API_KEY', '') if not api_key: raise RuntimeError('API_KEY is not set') ``` ### 3) Configure Environment Variable API_KEY - Purpose: provide a shared key source for local scripts. - Note: examples below read `api_key` from environment variable. Windows PowerShell�? ```powershell $env:API_KEY="your-api-key" ``` macOS / Linux (bash/zsh): ```bash export API_KEY="your-api-key" ``` ## Usage Examples (Python) ### Example A: Query Credits (`Credits`) ```python import os from scripts.skill_router import Skill skill = Skill('scripts/c_api_doc_detail.json') api_key = os.getenv('API_KEY', '') if not api_key: raise RuntimeError('API_KEY is not set') result = skill.invoke('Credits', {}, api_key=api_key) print(result) ``` ### Example B: Text-to-Image (`Imagen 4`) ```python import os from scripts.skill_router import Skill skill = Skill('scripts/c_api_doc_detail.json') api_key = os.getenv('API_KEY', '') if not api_key: raise RuntimeError('API_KEY is not set') result = skill.invoke( 'Imagen 4', { 'prompt': 'a cute puppy, photorealistic, soft natural light, high detail', 'ratio': '1:1', 'counts': '1' }, api_key=api_key ) print(result) # When code=0, data usually contains task_id. ``` ### Example C: Query Task Result (`Task Result`) ```python import os import time from scripts.skill_router import Skill skill = Skill('scripts/c_api_doc_detail.json') api_key = os.getenv('API_KEY', '') if not api_key: raise RuntimeError('API_KEY is not set') task_id = 'your-task-id' for _ in range(24): r = skill.invoke('Task Result', {'task_id': task_id}, api_key=api_key) print(r) status = (r.get('data') or {}).get('status') if status in ('completed', 'failed', 'succeeded'): break time.sleep(5) ``` ### Task Status Reference - `waiting`: queued - `processing`: running - `completed`: completed successfully - `failed`: failed - `timeout`: timed out ## Parameter Guidance (by Capability) - Text To Image / Image To Image / Video APIs: - Required parameters are defined by `required=true` in `api_body`. - Enum fields (for example `ratio`, `duration`, `resolution`) must use documented values. - `Task Result`: - Requires `task_id`, passed as `{'task_id': 'xxx'}` (path parameters are replaced automatically by the router). - `Credits`: - No business parameters are required; use `params={}`. ## Typical Invocation Flow 1. Call a generation API (for example `Imagen 4` or `Kling 3.0`) to obtain `task_id`. 2. Poll the same task using `Task Result`. 3. When status is `completed/succeeded`, extract output URLs from `data.result`. ## Error Handling Notes - API not found: returns `{"error": "API 'xxx' not found."}` - Request exception: returns `{"error": ""}` - Invalid response format: returns `{"error": "Invalid response", ...}` ## Additional Response Code Notes - `374004`: not authenticated. Apply for an APP KEY at https://developer.media.io/. - `490505`: insufficient credits. Recharge before invoking generation APIs. ## Important Implementation Notes - API names in `c_api_doc_detail.json` are unique, including text-to-video variants. - The router validates duplicate names at load time and fails fast if duplicates are reintroduced. - For best compatibility, invoke APIs by exact `name` from the JSON definition. ## Extension and Integration Recommendations - Add asynchronous invocation via `asyncio` or threads. - Auto-generate parameter validation and type hints from API metadata. - Package this skill as a microservice/API for multi-client integration. ## External Resources - API documentation: https://platform.media.io/docs/ - Product overview: https://developer.media.io/ - Credit purchase: https://developer.media.io/pricing.html ## Related Files - scripts/skill_router.py: core routing logic - scripts/c_api_doc_detail.json: API definitions FILE:references/mediaio-aigc-api-reference.md # MediaIO AIGC API Capability Reference (Generated from c_api_doc_detail.json) - Generated at: 2026-03-10 17:26:49 - Total APIs: 24 - Invocation pattern: Skill.invoke(api_name, params, api_key) - Important note: API names are unique in the current `c_api_doc_detail.json`; keep names unique to avoid routing ambiguity. ## 1. General Invocation Rules ### 1.1 Unified Entry Point ```python from scripts.skill_router import Skill import os skill = Skill('scripts/c_api_doc_detail.json') api_key = os.getenv('API_KEY', '') result = skill.invoke(api_name, params, api_key=api_key) print(result) ``` ### 1.2 Standard Async Workflow 1. Call a generation endpoint and obtain `data.task_id`. 2. Poll `Task Result` with the task ID. 3. When status becomes `completed` or `succeeded`, extract output URLs from `data.result`. ### 1.3 Common Status and Error Codes - Task status: `waiting`, `processing`, `completed`, `failed`, `timeout` - `374004`: authentication required / invalid API key - `490505`: insufficient credits ## 2. Capability Overview ### Query APIs (2) - Credits | model_code=user-credits | POST https://openapi.media.io/user/credits - Task Result | model_code=generation-result | POST https://openapi.media.io/generation/result/{task_id} ### Text To Image (2) - Imagen 4 | model_code=t2i-imagen-4 | POST https://openapi.media.io/generation/imagen/t2i-imagen-4 - soul_character | model_code=t2i-soul-character | POST https://openapi.media.io/generation/soul/t2i-soul-character ### Image To Image (3) - Nano Banana | model_code=i2i-banana | POST https://openapi.media.io/generation/banana/i2i-banana - Seedream 4.0 | model_code=i2i-seedream-v4-0 | POST https://openapi.media.io/generation/seedream/i2i-seedream-v4-0 - Nano Banana Pro | model_code=i2i-banana-2 | POST https://openapi.media.io/generation/banana/i2i-banana-2 ### Image To Video (14) - Wan 2.6 | model_code=i2v-wan-v2-6 | POST https://openapi.media.io/generation/wan/i2v-wan-v2-6 - Wan 2.2 | model_code=i2v-wan-v2-2 | POST https://openapi.media.io/generation/wan/i2v-wan-v2-2 - Hailuo 02 | model_code=i2v-minimax-02 | POST https://openapi.media.io/generation/minimax/i2v-minimax-02 - Kling 2.1 | model_code=i2v-kling-v2-1 | POST https://openapi.media.io/generation/kling/i2v-kling-v2-1 - Vidu Q3 | model_code=i2v-vidu-q3 | POST https://openapi.media.io/generation/vidu/i2v-vidu-q3 - Kling 2.5 Turbo | model_code=i2v-kling-v2-5-turbo | POST https://openapi.media.io/generation/kling/i2v-kling-v2-5-turbo - Google Veo 3.1 | model_code=i2v-veo-v3-1 | POST https://openapi.media.io/generation/veo/i2v-veo-v3-1 - Kling 3.0 | model_code=i2v-kling-v3-0 | POST https://openapi.media.io/generation/kling/i2v-kling-v3-0 - Hailuo 2.3 | model_code=i2v-minimax-v2-3 | POST https://openapi.media.io/generation/minimax/i2v-minimax-v2-3 - Vidu Q2 | model_code=i2v-vidu-q2 | POST https://openapi.media.io/generation/vidu/i2v-vidu-q2 - Wan 2.5 | model_code=i2v-wan-v2-5 | POST https://openapi.media.io/generation/wan/i2v-wan-v2-5 - Kling 2.6 | model_code=i2v-kling-v2-6 | POST https://openapi.media.io/generation/kling/i2v-kling-v2-6 - Motion Control Kling 2.6 | model_code=i2v-motion-control-kling-v2-6 | POST https://openapi.media.io/generation/kling/i2v-motion-control-kling-v2-6 - Google Veo 3.1 Fast | model_code=i2v-veo-v3-1-fast | POST https://openapi.media.io/generation/veo/i2v-veo-v3-1-fast ### Text To Video (3) - Wan 2.6 (Text To Video) | model_code=t2v-wan-v2-6 | POST https://openapi.media.io/generation/wan/t2v-wan-v2-6 - Vidu Q3 (Text To Video) | model_code=t2v-vidu-q3 | POST https://openapi.media.io/generation/vidu/t2v-vidu-q3 - Wan 2.5 (Text To Video) | model_code=t2v-wan-v2-5 | POST https://openapi.media.io/generation/wan/t2v-wan-v2-5 ## 3. Detailed API Documentation ### Query APIs #### Query APIs-1 Credits (model_code: user-credits) - API ID: 196 - Method: POST - Endpoint: https://openapi.media.io/user/credits - Description: API to query user credits balance. - Parameters: none (use `{}`) ##### Request Example ```json { "title": "Example Request", "request": [ { "title": "Query User Credits", "language": "cURL", "code_example": "curl --request POST \n --url https://openapi.media.io/user/credits \n --header 'Content-Type: application/json' \n --header 'X-API-KEY: ' \n --data '{}'" } ] } ``` ##### Response Example ```json { "list": [ { "name": "code", "type": "integer", "describe": "Response status code, 0 indicates success" }, { "name": "msg", "type": "string", "describe": "Response message, empty string on success" }, { "name": "data", "type": "object", "describe": "Response data object" }, { "name": "credits", "type": "integer", "describe": "User credits balance, located within the data object" } ], "title": "Response", "describe": "After the request is successfully processed, the server will return the following response" } ``` ##### Skill.invoke Template ```python result = skill.invoke( 'Credits', {}, api_key=api_key ) print(result) ``` #### Query APIs-2 Task Result (model_code: generation-result) - API ID: 197 - Method: POST - Endpoint: https://openapi.media.io/generation/result/{task_id} - Description: API to query generation task result by task ID. | Parameter | Type | Required | Description | |---|---|---|---| | task_id | string | Yes | The task ID to query, located in the URL path parameter | ##### Request Example ```json { "title": "Example Request", "request": [ { "title": "Query Task Result", "language": "cURL", "code_example": "curl --request POST \n --url https://openapi.media.io/generation/result/ \n --header 'Content-Type: application/json' \n --header 'X-API-KEY: ' \n --data '{}'" } ] } ``` ##### Response Example ```json { "list": [ { "name": "code", "type": "integer", "describe": "Response status code, 0 indicates success" }, { "name": "msg", "type": "string", "describe": "Response message, empty string on success" }, { "name": "data", "type": "object", "describe": "Response data object" }, { "name": "task_id", "type": "string", "describe": "Task identifier" }, { "name": "status", "type": "string", "describe": "Task status: pending, processing, succeeded, failed" }, { "name": "result", "type": "object", "describe": "Generation result when task succeeded" } ], "title": "Response", "describe": "After the request is successfully processed, the server will return the following response" } ``` ##### Skill.invoke Template ```python result = skill.invoke( 'Task Result', { "task_id": "" }, api_key=api_key ) print(result) ``` ### Text To Image #### Text To Image-1 Imagen 4 (model_code: t2i-imagen-4) - API ID: 259 - Method: POST - Endpoint: https://openapi.media.io/generation/imagen/t2i-imagen-4 - Description: Sets a new standard for photorealism and text rendering accuracy, handling the most complex prompts with ease. | Parameter | Type | Required | Description | |---|---|---|---| | prompt | string | Yes | The text prompt describing the content to generate. Maximum string length: 1200. | | ratio | string | No | Target aspect ratio. Options: 9:16, 16:9, 1:1, 4:3, 3:4. Default is 9:16. Allowed values: 9:16, 16:9, 1:1, 4:3, 3:4. | | counts | string | No | Counts parameter. Options: 1, 2, 3, 4. Default is 1. Allowed values: 1, 2, 3, 4. | ##### Request Example ```json { "title": "Example Request", "request": [ { "title": "create image by text or image", "language": "cURL", "code_example": "curl --request POST \\\n --url https://openapi.media.io/generation/imagen/t2i-imagen-4 \\\n --header 'Content-Type: application/json' \\\n --header 'X-API-KEY: ' \\\n --data '\n{\n \"data\": {\n \"counts\": \"1\",\n \"prompt\": \"\",\n \"ratio\": \"9:16\"\n }\n}'\n" } ], "describe": "", "response": [ { "type": "200", "code_example": "{\n \"code\": 0,\n \"msg\": \"\",\n \"data\": {\n \"task_id\": \"\n },\n \"trace_id\": \"\n}" }, { "type": "default", "code_example": "{\n \"code\": ,\n \"msg\": ,\n \"data\": {},\n \"trace_id\": \"\n}" } ] } ``` ##### Response Example ```json { "list": [ { "name": "code", "type": "integer", "describe": "Response status code, 0 indicates success" }, { "name": "msg", "type": "string", "describe": "Response message, empty string on success" }, { "name": "data", "type": "object", "describe": "Response data object" }, { "name": "task_id", "type": "string", "describe": "Unique task identifier, located within the data object" }, { "name": "trace_id", "type": "string", "describe": "Request tracking ID" } ], "title": "Response", "describe": "After the request is successfully processed, the server will return the following response" } ``` ##### Skill.invoke Template ```python result = skill.invoke( 'Imagen 4', { "prompt": "", "ratio": "", "counts": "" }, api_key=api_key ) print(result) ``` #### Text To Image-2 soul_character (model_code: t2i-soul-character) - API ID: 260 - Method: POST - Endpoint: https://openapi.media.io/generation/soul/t2i-soul-character - Description: Delivers the most cost-effective solution with ultra-fast generation speeds, perfect for high-volume commercial applications. | Parameter | Type | Required | Description | |---|---|---|---| | prompt | string | Yes | The text prompt describing the content to generate. Maximum string length: 2000. | | ratio | string | No | Target aspect ratio. Options: 2:3, 1:1, 3:2, 9:16, 16:9. Default is 16:9. Allowed values: 2:3, 1:1, 3:2, 9:16, 16:9. | ##### Request Example ```json { "title": "Example Request", "request": [ { "title": "create image by text or image", "language": "cURL", "code_example": "curl --request POST \\\n --url https://openapi.media.io/generation/soul/t2i-soul-character \\\n --header 'Content-Type: application/json' \\\n --header 'X-API-KEY: ' \\\n --data '\n{\n \"data\": {\n \"prompt\": \"\",\n \"ratio\": \"16:9\"\n }\n}'\n" } ], "describe": "", "response": [ { "type": "200", "code_example": "{\n \"code\": 0,\n \"msg\": \"\",\n \"data\": {\n \"task_id\": \"\n },\n \"trace_id\": \"\n}" }, { "type": "default", "code_example": "{\n \"code\": ,\n \"msg\": ,\n \"data\": {},\n \"trace_id\": \"\n}" } ] } ``` ##### Response Example ```json { "list": [ { "name": "code", "type": "integer", "describe": "Response status code, 0 indicates success" }, { "name": "msg", "type": "string", "describe": "Response message, empty string on success" }, { "name": "data", "type": "object", "describe": "Response data object" }, { "name": "task_id", "type": "string", "describe": "Unique task identifier, located within the data object" }, { "name": "trace_id", "type": "string", "describe": "Request tracking ID" } ], "title": "Response", "describe": "After the request is successfully processed, the server will return the following response" } ``` ##### Skill.invoke Template ```python result = skill.invoke( 'soul_character', { "prompt": "", "ratio": "" }, api_key=api_key ) print(result) ``` ### Image To Image #### Image To Image-1 Nano Banana (model_code: i2i-banana) - API ID: 242 - Method: POST - Endpoint: https://openapi.media.io/generation/banana/i2i-banana - Description: Utilizes next-gen multimodal reasoning to generate images that perfectly align with nuanced conceptual descriptions. | Parameter | Type | Required | Description | |---|---|---|---| | images | array | Yes | The URLs of the input images. Supported formats include PNG, JPEG, and JPG. File size must be between 0.0 MB and 20.0 MB. Image resolution must be between 300x300 and 1280x1280. Aspect ratio must be between 1:2 and 2:1. Maximum 9 file(s). | | prompt | string | Yes | The text prompt describing the content to generate. Maximum string length: 1200. | | ratio | string | No | Target aspect ratio. Options: 9:16, 16:9, 1:1, 4:3, 3:4, 3:2, 2:3, 21:9. Default is 16:9. Allowed values: 9:16, 16:9, 1:1, 4:3, 3:4, 3:2, 2:3, 21:9. | ##### Request Example ```json { "title": "Example Request", "request": [ { "title": "create image by text or image", "language": "cURL", "code_example": "curl --request POST \\\n --url https://openapi.media.io/generation/banana/i2i-banana \\\n --header 'Content-Type: application/json' \\\n --header 'X-API-KEY: ' \\\n --data '\n{\n \"data\": {\n \"images\": [\n \"\"\n ],\n \"prompt\": \"\",\n \"ratio\": \"16:9\"\n }\n}'\n" } ], "describe": "", "response": [ { "type": "200", "code_example": "{\n \"code\": 0,\n \"msg\": \"\",\n \"data\": {\n \"task_id\": \"\n },\n \"trace_id\": \"\n}" }, { "type": "default", "code_example": "{\n \"code\": ,\n \"msg\": ,\n \"data\": {},\n \"trace_id\": \"\n}" } ] } ``` ##### Response Example ```json { "list": [ { "name": "code", "type": "integer", "describe": "Response status code, 0 indicates success" }, { "name": "msg", "type": "string", "describe": "Response message, empty string on success" }, { "name": "data", "type": "object", "describe": "Response data object" }, { "name": "task_id", "type": "string", "describe": "Unique task identifier, located within the data object" }, { "name": "trace_id", "type": "string", "describe": "Request tracking ID" } ], "title": "Response", "describe": "After the request is successfully processed, the server will return the following response" } ``` ##### Skill.invoke Template ```python result = skill.invoke( 'Nano Banana', { "images": "", "prompt": "", "ratio": "" }, api_key=api_key ) print(result) ``` #### Image To Image-2 Seedream 4.0 (model_code: i2i-seedream-v4-0) - API ID: 243 - Method: POST - Endpoint: https://openapi.media.io/generation/seedream/i2i-seedream-v4-0 - Description: A versatile powerhouse supporting 4K generation and advanced editing, ensuring character and style consistency. | Parameter | Type | Required | Description | |---|---|---|---| | images | array | Yes | The URLs of the input images. Supported formats include PNG, JPEG, and JPG. File size must be between 0.0 MB and 10.0 MB. Image resolution must be between 300x300 and 1280x1280. Aspect ratio must be between 3:10 and 3:1. Maximum 9 file(s). | | prompt | string | Yes | The text prompt describing the content to generate. Maximum string length: 800. | | ratio | string | No | Target aspect ratio. Options: 9:16, 16:9, 1:1, 4:3, 3:4, 3:2, 2:3. Default is 9:16. Allowed values: 9:16, 16:9, 1:1, 4:3, 3:4, 3:2, 2:3. | ##### Request Example ```json { "title": "Example Request", "request": [ { "title": "create image by text or image", "language": "cURL", "code_example": "curl --request POST \\\n --url https://openapi.media.io/generation/seedream/i2i-seedream-v4-0 \\\n --header 'Content-Type: application/json' \\\n --header 'X-API-KEY: ' \\\n --data '\n{\n \"data\": {\n \"images\": [\n \"\"\n ],\n \"prompt\": \"\",\n \"ratio\": \"9:16\"\n }\n}'\n" } ], "describe": "", "response": [ { "type": "200", "code_example": "{\n \"code\": 0,\n \"msg\": \"\",\n \"data\": {\n \"task_id\": \"\n },\n \"trace_id\": \"\n}" }, { "type": "default", "code_example": "{\n \"code\": ,\n \"msg\": ,\n \"data\": {},\n \"trace_id\": \"\n}" } ] } ``` ##### Response Example ```json { "list": [ { "name": "code", "type": "integer", "describe": "Response status code, 0 indicates success" }, { "name": "msg", "type": "string", "describe": "Response message, empty string on success" }, { "name": "data", "type": "object", "describe": "Response data object" }, { "name": "task_id", "type": "string", "describe": "Unique task identifier, located within the data object" }, { "name": "trace_id", "type": "string", "describe": "Request tracking ID" } ], "title": "Response", "describe": "After the request is successfully processed, the server will return the following response" } ``` ##### Skill.invoke Template ```python result = skill.invoke( 'Seedream 4.0', { "images": "", "prompt": "", "ratio": "" }, api_key=api_key ) print(result) ``` #### Image To Image-3 Nano Banana Pro (model_code: i2i-banana-2) - API ID: 244 - Method: POST - Endpoint: https://openapi.media.io/generation/banana/i2i-banana-2 - Description: Utilizes next-gen multimodal reasoning to generate images that perfectly align with nuanced conceptual descriptions. | Parameter | Type | Required | Description | |---|---|---|---| | images | array | Yes | The URLs of the input images. Supported formats include PNG, JPEG, and JPG. File size must be between 0.0 MB and 20.0 MB. Image resolution must be between 300x300 and 1280x1280. Aspect ratio must be between 1:2 and 2:1. Maximum 9 file(s). | | prompt | string | Yes | The text prompt describing the content to generate. Maximum string length: 1200. | | ratio | string | No | Target aspect ratio. Options: 9:16, 16:9, 1:1, 4:3, 3:4, 3:2, 2:3, 21:9. Default is 16:9. Allowed values: 9:16, 16:9, 1:1, 4:3, 3:4, 3:2, 2:3, 21:9. | | resolution | string | No | Output resolution. Options: 1K, 2K, 4K. Default is 1K. Allowed values: 1K, 2K, 4K. | ##### Request Example ```json { "title": "Example Request", "request": [ { "title": "create image by text or image", "language": "cURL", "code_example": "curl --request POST \\\n --url https://openapi.media.io/generation/banana/i2i-banana-2 \\\n --header 'Content-Type: application/json' \\\n --header 'X-API-KEY: ' \\\n --data '\n{\n \"data\": {\n \"images\": [\n \"\"\n ],\n \"prompt\": \"\",\n \"ratio\": \"16:9\",\n \"resolution\": \"1K\"\n }\n}'\n" } ], "describe": "", "response": [ { "type": "200", "code_example": "{\n \"code\": 0,\n \"msg\": \"\",\n \"data\": {\n \"task_id\": \"\n },\n \"trace_id\": \"\n}" }, { "type": "default", "code_example": "{\n \"code\": ,\n \"msg\": ,\n \"data\": {},\n \"trace_id\": \"\n}" } ] } ``` ##### Response Example ```json { "list": [ { "name": "code", "type": "integer", "describe": "Response status code, 0 indicates success" }, { "name": "msg", "type": "string", "describe": "Response message, empty string on success" }, { "name": "data", "type": "object", "describe": "Response data object" }, { "name": "task_id", "type": "string", "describe": "Unique task identifier, located within the data object" }, { "name": "trace_id", "type": "string", "describe": "Request tracking ID" } ], "title": "Response", "describe": "After the request is successfully processed, the server will return the following response" } ``` ##### Skill.invoke Template ```python result = skill.invoke( 'Nano Banana Pro', { "images": "", "prompt": "", "ratio": "", "resolution": "" }, api_key=api_key ) print(result) ``` ### Image To Video #### Image To Video-1 Wan 2.6 (model_code: i2v-wan-v2-6) - API ID: 245 - Method: POST - Endpoint: https://openapi.media.io/generation/wan/i2v-wan-v2-6 - Description: Features advanced multi-shot storytelling and native audio-visual synchronization, ideal for creating complex narratives with consistent characters. | Parameter | Type | Required | Description | |---|---|---|---| | image | string | Yes | The URL of the input image. Supported formats include PNG, JPEG, JPG, WEBP, and BMP. File size must be between 0.0 MB and 10.0 MB. Image resolution must be between 300x300 and 2000x2000. Aspect ratio must be between 0.4:1 and 2.5:1. | | prompt | string | Yes | The text prompt describing the content to generate. Maximum string length: 1500. | | resolution | string | No | Output resolution. Options: 720P, 1080P. Default is 720P. Allowed values: 720P, 1080P. | | duration | string | No | Video duration in seconds. Options: 5s, 10s, 15s. Default is 5s. Allowed values: 5s, 10s, 15s. | | shot_type | string | No | Shot Type parameter. Options: Multi, Single. Default is Multi. Allowed values: Multi, Single. | | generate_audio | string | No | Generate Audio parameter. Options: True, False. Default is True. Allowed values: True, False. | ##### Request Example ```json { "title": "Example Request", "request": [ { "title": "create video by text or image", "language": "cURL", "code_example": "curl --request POST \\\n --url https://openapi.media.io/generation/wan/i2v-wan-v2-6 \\\n --header 'Content-Type: application/json' \\\n --header 'X-API-KEY: ' \\\n --data '\n{\n \"data\": {\n \"duration\": \"5s\",\n \"generate_audio\": \"True\",\n \"image\": \"\",\n \"prompt\": \"\",\n \"resolution\": \"720P\",\n \"shot_type\": \"Multi\"\n }\n}'\n" } ], "describe": "", "response": [ { "type": "200", "code_example": "{\n \"code\": 0,\n \"msg\": \"\",\n \"data\": {\n \"task_id\": \"\n },\n \"trace_id\": \"\n}" }, { "type": "default", "code_example": "{\n \"code\": ,\n \"msg\": ,\n \"data\": {},\n \"trace_id\": \"\n}" } ] } ``` ##### Response Example ```json { "list": [ { "name": "code", "type": "integer", "describe": "Response status code, 0 indicates success" }, { "name": "msg", "type": "string", "describe": "Response message, empty string on success" }, { "name": "data", "type": "object", "describe": "Response data object" }, { "name": "task_id", "type": "string", "describe": "Unique task identifier, located within the data object" }, { "name": "trace_id", "type": "string", "describe": "Request tracking ID" } ], "title": "Response", "describe": "After the request is successfully processed, the server will return the following response" } ``` ##### Skill.invoke Template ```python result = skill.invoke( 'Wan 2.6', { "image": "", "prompt": "", "resolution": "", "duration": "", "shot_type": "", "generate_audio": "" }, api_key=api_key ) print(result) ``` #### Image To Video-2 Wan 2.2 (model_code: i2v-wan-v2-2) - API ID: 246 - Method: POST - Endpoint: https://openapi.media.io/generation/wan/i2v-wan-v2-2 - Description: A balanced video generation model offering reliable motion quality and prompt adherence for general tasks. | Parameter | Type | Required | Description | |---|---|---|---| | image | string | Yes | The URL of the input image. Supported formats include PNG, JPEG, JPG, WEBP, and BMP. File size must be between 0.0 MB and 10.0 MB. Image resolution must be between 300x300 and 2000x2000. Aspect ratio must be between 0.4:1 and 2.5:1. | | prompt | string | Yes | The text prompt describing the content to generate. Maximum string length: 800. | | resolution | string | No | Output resolution. Options: 1080P. Default is 1080P. Allowed values: 1080P. | | duration | string | No | Video duration in seconds. Options: 5s. Default is 5s. Allowed values: 5s. | ##### Request Example ```json { "title": "Example Request", "request": [ { "title": "create video by text or image", "language": "cURL", "code_example": "curl --request POST \\\n --url https://openapi.media.io/generation/wan/i2v-wan-v2-2 \\\n --header 'Content-Type: application/json' \\\n --header 'X-API-KEY: ' \\\n --data '\n{\n \"data\": {\n \"duration\": \"5s\",\n \"image\": \"\",\n \"prompt\": \"\",\n \"resolution\": \"1080P\"\n }\n}'\n" } ], "describe": "", "response": [ { "type": "200", "code_example": "{\n \"code\": 0,\n \"msg\": \"\",\n \"data\": {\n \"task_id\": \"\n },\n \"trace_id\": \"\n}" }, { "type": "default", "code_example": "{\n \"code\": ,\n \"msg\": ,\n \"data\": {},\n \"trace_id\": \"\n}" } ] } ``` ##### Response Example ```json { "list": [ { "name": "code", "type": "integer", "describe": "Response status code, 0 indicates success" }, { "name": "msg", "type": "string", "describe": "Response message, empty string on success" }, { "name": "data", "type": "object", "describe": "Response data object" }, { "name": "task_id", "type": "string", "describe": "Unique task identifier, located within the data object" }, { "name": "trace_id", "type": "string", "describe": "Request tracking ID" } ], "title": "Response", "describe": "After the request is successfully processed, the server will return the following response" } ``` ##### Skill.invoke Template ```python result = skill.invoke( 'Wan 2.2', { "image": "", "prompt": "", "resolution": "", "duration": "" }, api_key=api_key ) print(result) ``` #### Image To Video-3 Hailuo 02 (model_code: i2v-minimax-02) - API ID: 247 - Method: POST - Endpoint: https://openapi.media.io/generation/minimax/i2v-minimax-02 - Description: Excels in cinematic realism and complex physics simulation, offering 'Director-level' control over camera movements and high fidelity. | Parameter | Type | Required | Description | |---|---|---|---| | image | string | Yes | The URL of the input image. Supported formats include PNG, JPEG, JPG, WEBP, GIF, and HEIC. File size must be between 0.0 MB and 20.0 MB. Image resolution must be between 300x300 and 4000x4000. Aspect ratio must be between 0.4:1 and 2.5:1. | | prompt | string | Yes | The text prompt describing the content to generate. Maximum string length: 2000. | | duration | string | No | Video duration in seconds. Options: 6s. Default is 6s. Allowed values: 6s. | | resolution | string | No | Output resolution. Options: 768P, 1080P. Default is 768P. Allowed values: 768P, 1080P. | ##### Request Example ```json { "title": "Example Request", "request": [ { "title": "create video by text or image", "language": "cURL", "code_example": "curl --request POST \\\n --url https://openapi.media.io/generation/minimax/i2v-minimax-02 \\\n --header 'Content-Type: application/json' \\\n --header 'X-API-KEY: ' \\\n --data '\n{\n \"data\": {\n \"duration\": \"6s\",\n \"image\": \"\",\n \"prompt\": \"\",\n \"resolution\": \"768P\"\n }\n}'\n" } ], "describe": "", "response": [ { "type": "200", "code_example": "{\n \"code\": 0,\n \"msg\": \"\",\n \"data\": {\n \"task_id\": \"\n },\n \"trace_id\": \"\n}" }, { "type": "default", "code_example": "{\n \"code\": ,\n \"msg\": ,\n \"data\": {},\n \"trace_id\": \"\n}" } ] } ``` ##### Response Example ```json { "list": [ { "name": "code", "type": "integer", "describe": "Response status code, 0 indicates success" }, { "name": "msg", "type": "string", "describe": "Response message, empty string on success" }, { "name": "data", "type": "object", "describe": "Response data object" }, { "name": "task_id", "type": "string", "describe": "Unique task identifier, located within the data object" }, { "name": "trace_id", "type": "string", "describe": "Request tracking ID" } ], "title": "Response", "describe": "After the request is successfully processed, the server will return the following response" } ``` ##### Skill.invoke Template ```python result = skill.invoke( 'Hailuo 02', { "image": "", "prompt": "", "duration": "", "resolution": "" }, api_key=api_key ) print(result) ``` #### Image To Video-4 Kling 2.1 (model_code: i2v-kling-v2-1) - API ID: 248 - Method: POST - Endpoint: https://openapi.media.io/generation/kling/i2v-kling-v2-1 - Description: A robust model known for producing realistic videos with stable motion and good prompt understanding. | Parameter | Type | Required | Description | |---|---|---|---| | image | string | Yes | The URL of the input image. Supported formats include PNG, JPEG, JPG, WEBP, GIF, and HEIC. File size must be between 0.0 MB and 20.0 MB. Image resolution must be between 300x300 and 4000x4000. Aspect ratio must be between 0.4:1 and 2.5:1. | | prompt | string | Yes | The text prompt describing the content to generate. Maximum string length: 2000. | | duration | string | No | Video duration in seconds. Options: 5s, 10s. Default is 5s. Allowed values: 5s, 10s. | | resolution | string | No | Output resolution. Options: 720P, 1080P. Default is 720P. Allowed values: 720P, 1080P. | ##### Request Example ```json { "title": "Example Request", "request": [ { "title": "create video by text or image", "language": "cURL", "code_example": "curl --request POST \\\n --url https://openapi.media.io/generation/kling/i2v-kling-v2-1 \\\n --header 'Content-Type: application/json' \\\n --header 'X-API-KEY: ' \\\n --data '\n{\n \"data\": {\n \"duration\": \"5s\",\n \"image\": \"\",\n \"prompt\": \"\",\n \"resolution\": \"720P\"\n }\n}'\n" } ], "describe": "", "response": [ { "type": "200", "code_example": "{\n \"code\": 0,\n \"msg\": \"\",\n \"data\": {\n \"task_id\": \"\n },\n \"trace_id\": \"\n}" }, { "type": "default", "code_example": "{\n \"code\": ,\n \"msg\": ,\n \"data\": {},\n \"trace_id\": \"\n}" } ] } ``` ##### Response Example ```json { "list": [ { "name": "code", "type": "integer", "describe": "Response status code, 0 indicates success" }, { "name": "msg", "type": "string", "describe": "Response message, empty string on success" }, { "name": "data", "type": "object", "describe": "Response data object" }, { "name": "task_id", "type": "string", "describe": "Unique task identifier, located within the data object" }, { "name": "trace_id", "type": "string", "describe": "Request tracking ID" } ], "title": "Response", "describe": "After the request is successfully processed, the server will return the following response" } ``` ##### Skill.invoke Template ```python result = skill.invoke( 'Kling 2.1', { "image": "", "prompt": "", "duration": "", "resolution": "" }, api_key=api_key ) print(result) ``` #### Image To Video-5 Vidu Q3 (model_code: i2v-vidu-q3) - API ID: 249 - Method: POST - Endpoint: https://openapi.media.io/generation/vidu/i2v-vidu-q3 - Description: The latest iteration optimized for superior speed and high-definition output, enabling rapid high-quality video creation. | Parameter | Type | Required | Description | |---|---|---|---| | image | string | Yes | The URL of the input image. Supported formats include PNG, JPEG, and JPG. File size must be between 0.0 MB and 10.0 MB. Image resolution must be between 150x150 and 4000x4000. Aspect ratio must be between 1:4 and 4:1. | | prompt | string | Yes | The text prompt describing the content to generate. Maximum string length: 2000. | | resolution | string | No | Output resolution. Options: 540P, 720P, 1080P. Default is 720P. Allowed values: 540P, 720P, 1080P. | | duration | string | No | Video duration in seconds. Options: 4s, 8s, 12s, 16s. Default is 4s. Allowed values: 4s, 8s, 12s, 16s. | | generate_audio | string | No | Generate Audio parameter. Options: True, False. Default is True. Allowed values: True, False. | ##### Request Example ```json { "title": "Example Request", "request": [ { "title": "create video by text or image", "language": "cURL", "code_example": "curl --request POST \\\n --url https://openapi.media.io/generation/vidu/i2v-vidu-q3 \\\n --header 'Content-Type: application/json' \\\n --header 'X-API-KEY: ' \\\n --data '\n{\n \"data\": {\n \"duration\": \"4s\",\n \"generate_audio\": \"True\",\n \"image\": \"\",\n \"prompt\": \"\",\n \"resolution\": \"720P\"\n }\n}'\n" } ], "describe": "", "response": [ { "type": "200", "code_example": "{\n \"code\": 0,\n \"msg\": \"\",\n \"data\": {\n \"task_id\": \"\n },\n \"trace_id\": \"\n}" }, { "type": "default", "code_example": "{\n \"code\": ,\n \"msg\": ,\n \"data\": {},\n \"trace_id\": \"\n}" } ] } ``` ##### Response Example ```json { "list": [ { "name": "code", "type": "integer", "describe": "Response status code, 0 indicates success" }, { "name": "msg", "type": "string", "describe": "Response message, empty string on success" }, { "name": "data", "type": "object", "describe": "Response data object" }, { "name": "task_id", "type": "string", "describe": "Unique task identifier, located within the data object" }, { "name": "trace_id", "type": "string", "describe": "Request tracking ID" } ], "title": "Response", "describe": "After the request is successfully processed, the server will return the following response" } ``` ##### Skill.invoke Template ```python result = skill.invoke( 'Vidu Q3', { "image": "", "prompt": "", "resolution": "", "duration": "", "generate_audio": "" }, api_key=api_key ) print(result) ``` #### Image To Video-6 Kling 2.5 Turbo (model_code: i2v-kling-v2-5-turbo) - API ID: 251 - Method: POST - Endpoint: https://openapi.media.io/generation/kling/i2v-kling-v2-5-turbo - Description: Offers advanced motion control and high realism, bridging the gap between standard and professional output. | Parameter | Type | Required | Description | |---|---|---|---| | image | string | Yes | The URL of the input image. Supported formats include PNG, JPEG, JPG, WEBP, GIF, and HEIC. File size must be between 0.0 MB and 20.0 MB. Image resolution must be between 300x300 and 4000x4000. Aspect ratio must be between 0.4:1 and 2.5:1. | | prompt | string | Yes | The text prompt describing the content to generate. Maximum string length: 2500. | | duration | string | No | Video duration in seconds. Options: 5s, 10s. Default is 5s. Allowed values: 5s, 10s. | | resolution | string | No | Output resolution. Options: 720P, 1080P. Default is 1080P. Allowed values: 720P, 1080P. | ##### Request Example ```json { "title": "Example Request", "request": [ { "title": "create video by text or image", "language": "cURL", "code_example": "curl --request POST \\\n --url https://openapi.media.io/generation/kling/i2v-kling-v2-5-turbo \\\n --header 'Content-Type: application/json' \\\n --header 'X-API-KEY: ' \\\n --data '\n{\n \"data\": {\n \"duration\": \"5s\",\n \"image\": \"\",\n \"prompt\": \"\",\n \"resolution\": \"1080P\"\n }\n}'\n" } ], "describe": "", "response": [ { "type": "200", "code_example": "{\n \"code\": 0,\n \"msg\": \"\",\n \"data\": {\n \"task_id\": \"\n },\n \"trace_id\": \"\n}" }, { "type": "default", "code_example": "{\n \"code\": ,\n \"msg\": ,\n \"data\": {},\n \"trace_id\": \"\n}" } ] } ``` ##### Response Example ```json { "list": [ { "name": "code", "type": "integer", "describe": "Response status code, 0 indicates success" }, { "name": "msg", "type": "string", "describe": "Response message, empty string on success" }, { "name": "data", "type": "object", "describe": "Response data object" }, { "name": "task_id", "type": "string", "describe": "Unique task identifier, located within the data object" }, { "name": "trace_id", "type": "string", "describe": "Request tracking ID" } ], "title": "Response", "describe": "After the request is successfully processed, the server will return the following response" } ``` ##### Skill.invoke Template ```python result = skill.invoke( 'Kling 2.5 Turbo', { "image": "", "prompt": "", "duration": "", "resolution": "" }, api_key=api_key ) print(result) ``` #### Image To Video-7 Google Veo 3.1 (model_code: i2v-veo-v3-1) - API ID: 252 - Method: POST - Endpoint: https://openapi.media.io/generation/veo/i2v-veo-v3-1 - Description: A state-of-the-art model offering exceptional resolution and deep understanding of complex prompts for cinematic results. | Parameter | Type | Required | Description | |---|---|---|---| | image | string | Yes | The URL of the input image. Supported formats include JPG, JPEG, PNG, WEBP, GIF, and HEIC. File size must be between 0.0 MB and 50.0 MB. Image resolution must be between 300x300 and 4000x4000. Aspect ratio must be between 0.4:1 and 2:1. | | prompt | string | Yes | The text prompt describing the content to generate. Maximum string length: 1000. | | aspect_ratio | string | No | Target aspect ratio. Options: 9:16, 16:9. Default is 9:16. Allowed values: 9:16, 16:9. | | resolution | string | No | Output resolution. Options: 720P, 1080P. Default is 720P. Allowed values: 720P, 1080P. | | duration | string | No | Video duration in seconds. Options: 4s, 6s, 8s. Default is 4s. Allowed values: 4s, 6s, 8s. | | generate_audio | string | No | Generate Audio parameter. Options: True, False. Default is True. Allowed values: True, False. | ##### Request Example ```json { "title": "Example Request", "request": [ { "title": "create video by text or image", "language": "cURL", "code_example": "curl --request POST \\\n --url https://openapi.media.io/generation/veo/i2v-veo-v3-1 \\\n --header 'Content-Type: application/json' \\\n --header 'X-API-KEY: ' \\\n --data '\n{\n \"data\": {\n \"aspect_ratio\": \"9:16\",\n \"duration\": \"4s\",\n \"generate_audio\": \"True\",\n \"image\": \"\",\n \"prompt\": \"\",\n \"resolution\": \"720P\"\n }\n}'\n" } ], "describe": "", "response": [ { "type": "200", "code_example": "{\n \"code\": 0,\n \"msg\": \"\",\n \"data\": {\n \"task_id\": \"\n },\n \"trace_id\": \"\n}" }, { "type": "default", "code_example": "{\n \"code\": ,\n \"msg\": ,\n \"data\": {},\n \"trace_id\": \"\n}" } ] } ``` ##### Response Example ```json { "list": [ { "name": "code", "type": "integer", "describe": "Response status code, 0 indicates success" }, { "name": "msg", "type": "string", "describe": "Response message, empty string on success" }, { "name": "data", "type": "object", "describe": "Response data object" }, { "name": "task_id", "type": "string", "describe": "Unique task identifier, located within the data object" }, { "name": "trace_id", "type": "string", "describe": "Request tracking ID" } ], "title": "Response", "describe": "After the request is successfully processed, the server will return the following response" } ``` ##### Skill.invoke Template ```python result = skill.invoke( 'Google Veo 3.1', { "image": "", "prompt": "", "aspect_ratio": "", "resolution": "", "duration": "", "generate_audio": "" }, api_key=api_key ) print(result) ``` #### Image To Video-8 Kling 3.0 (model_code: i2v-kling-v3-0) - API ID: 253 - Method: POST - Endpoint: https://openapi.media.io/generation/kling/i2v-kling-v3-0 - Description: The latest high-fidelity generation delivering ultra-realistic motion and superior detail, suitable for professional-grade video production. | Parameter | Type | Required | Description | |---|---|---|---| | image | string | Yes | The URL of the input image. Supported formats include PNG, JPEG, JPG, WEBP, GIF, and HEIC. File size must be between 0.0 MB and 20.0 MB. Image resolution must be between 300x300 and 4000x4000. Aspect ratio must be between 0.4:1 and 2.5:1. | | prompt | string | Yes | The text prompt describing the content to generate. Maximum string length: 2500. | | resolution | string | No | Output resolution. Options: 720P, 1080P. Default is 1080P. Allowed values: 720P, 1080P. | | duration | string | No | Video duration in seconds. Options: 5s, 8s, 10s, 15s. Default is 5s. Allowed values: 5s, 8s, 10s, 15s. | | multi_shots | string | No | Multi Shots parameter. Options: True, False. Default is True. Allowed values: True, False. | | generate_audio | string | No | Generate Audio parameter. Options: True, False. Default is True. Allowed values: True, False. | ##### Request Example ```json { "title": "Example Request", "request": [ { "title": "create video by text or image", "language": "cURL", "code_example": "curl --request POST \\\n --url https://openapi.media.io/generation/kling/i2v-kling-v3-0 \\\n --header 'Content-Type: application/json' \\\n --header 'X-API-KEY: ' \\\n --data '\n{\n \"data\": {\n \"duration\": \"5s\",\n \"generate_audio\": \"True\",\n \"image\": \"\",\n \"multi_shots\": \"True\",\n \"prompt\": \"\",\n \"resolution\": \"1080P\"\n }\n}'\n" } ], "describe": "", "response": [ { "type": "200", "code_example": "{\n \"code\": 0,\n \"msg\": \"\",\n \"data\": {\n \"task_id\": \"\n },\n \"trace_id\": \"\n}" }, { "type": "default", "code_example": "{\n \"code\": ,\n \"msg\": ,\n \"data\": {},\n \"trace_id\": \"\n}" } ] } ``` ##### Response Example ```json { "list": [ { "name": "code", "type": "integer", "describe": "Response status code, 0 indicates success" }, { "name": "msg", "type": "string", "describe": "Response message, empty string on success" }, { "name": "data", "type": "object", "describe": "Response data object" }, { "name": "task_id", "type": "string", "describe": "Unique task identifier, located within the data object" }, { "name": "trace_id", "type": "string", "describe": "Request tracking ID" } ], "title": "Response", "describe": "After the request is successfully processed, the server will return the following response" } ``` ##### Skill.invoke Template ```python result = skill.invoke( 'Kling 3.0', { "image": "", "prompt": "", "resolution": "", "duration": "", "multi_shots": "", "generate_audio": "" }, api_key=api_key ) print(result) ``` #### Image To Video-9 Hailuo 2.3 (model_code: i2v-minimax-v2-3) - API ID: 254 - Method: POST - Endpoint: https://openapi.media.io/generation/minimax/i2v-minimax-v2-3 - Description: Excels in cinematic realism and complex physics simulation, offering 'Director-level' control over camera movements and high fidelity. | Parameter | Type | Required | Description | |---|---|---|---| | image | string | Yes | The URL of the input image. Supported formats include PNG, JPEG, JPG, WEBP, GIF, and HEIC. File size must be between 0.0 MB and 20.0 MB. Image resolution must be between 300x300 and 4000x4000. Aspect ratio must be between 0.4:1 and 2.5:1. | | prompt | string | Yes | The text prompt describing the content to generate. Maximum string length: 2000. | | resolution | string | No | Output resolution. Options: 768P, 1080P (when duration is 6s). Default is 768P. Allowed values: 768P, 1080P. | | duration | string | No | Video duration in seconds. Options: 6s, 10s. Default is 6s. Allowed values: 6s, 10s. | ##### Request Example ```json { "title": "Example Request", "request": [ { "title": "create video by text or image", "language": "cURL", "code_example": "curl --request POST \\\n --url https://openapi.media.io/generation/minimax/i2v-minimax-v2-3 \\\n --header 'Content-Type: application/json' \\\n --header 'X-API-KEY: ' \\\n --data '\n{\n \"data\": {\n \"duration\": \"6s\",\n \"image\": \"\",\n \"prompt\": \"\",\n \"resolution\": \"768P\"\n }\n}'\n" } ], "describe": "", "response": [ { "type": "200", "code_example": "{\n \"code\": 0,\n \"msg\": \"\",\n \"data\": {\n \"task_id\": \"\n },\n \"trace_id\": \"\n}" }, { "type": "default", "code_example": "{\n \"code\": ,\n \"msg\": ,\n \"data\": {},\n \"trace_id\": \"\n}" } ] } ``` ##### Response Example ```json { "list": [ { "name": "code", "type": "integer", "describe": "Response status code, 0 indicates success" }, { "name": "msg", "type": "string", "describe": "Response message, empty string on success" }, { "name": "data", "type": "object", "describe": "Response data object" }, { "name": "task_id", "type": "string", "describe": "Unique task identifier, located within the data object" }, { "name": "trace_id", "type": "string", "describe": "Request tracking ID" } ], "title": "Response", "describe": "After the request is successfully processed, the server will return the following response" } ``` ##### Skill.invoke Template ```python result = skill.invoke( 'Hailuo 2.3', { "image": "", "prompt": "", "resolution": "", "duration": "" }, api_key=api_key ) print(result) ``` #### Image To Video-10 Vidu Q2 (model_code: i2v-vidu-q2) - API ID: 255 - Method: POST - Endpoint: https://openapi.media.io/generation/vidu/i2v-vidu-q2 - Description: A fast and efficient model that balances generation speed with good visual fidelity. | Parameter | Type | Required | Description | |---|---|---|---| | image | string | Yes | The URL of the input image. Supported formats include PNG, JPEG, JPG, WEBP, GIF, and HEIC. File size must be between 0.0 MB and 10.0 MB. Image resolution must be between 150x150 and 4000x4000. Aspect ratio must be between 1:4 and 4:1. | | prompt | string | Yes | The text prompt describing the content to generate. Maximum string length: 2000. | | duration | string | No | Video duration in seconds. Options: 4s, 6s, 8s. Default is 4s. Allowed values: 4s, 6s, 8s. | | resolution | string | No | Output resolution. Options: 720P, 1080P. Default is 720P. Allowed values: 720P, 1080P. | ##### Request Example ```json { "title": "Example Request", "request": [ { "title": "create video by text or image", "language": "cURL", "code_example": "curl --request POST \\\n --url https://openapi.media.io/generation/vidu/i2v-vidu-q2 \\\n --header 'Content-Type: application/json' \\\n --header 'X-API-KEY: ' \\\n --data '\n{\n \"data\": {\n \"duration\": \"4s\",\n \"image\": \"\",\n \"prompt\": \"\",\n \"resolution\": \"720P\"\n }\n}'\n" } ], "describe": "", "response": [ { "type": "200", "code_example": "{\n \"code\": 0,\n \"msg\": \"\",\n \"data\": {\n \"task_id\": \"\n },\n \"trace_id\": \"\n}" }, { "type": "default", "code_example": "{\n \"code\": ,\n \"msg\": ,\n \"data\": {},\n \"trace_id\": \"\n}" } ] } ``` ##### Response Example ```json { "list": [ { "name": "code", "type": "integer", "describe": "Response status code, 0 indicates success" }, { "name": "msg", "type": "string", "describe": "Response message, empty string on success" }, { "name": "data", "type": "object", "describe": "Response data object" }, { "name": "task_id", "type": "string", "describe": "Unique task identifier, located within the data object" }, { "name": "trace_id", "type": "string", "describe": "Request tracking ID" } ], "title": "Response", "describe": "After the request is successfully processed, the server will return the following response" } ``` ##### Skill.invoke Template ```python result = skill.invoke( 'Vidu Q2', { "image": "", "prompt": "", "duration": "", "resolution": "" }, api_key=api_key ) print(result) ``` #### Image To Video-11 Wan 2.5 (model_code: i2v-wan-v2-5) - API ID: 256 - Method: POST - Endpoint: https://openapi.media.io/generation/wan/i2v-wan-v2-5 - Description: An enhanced version offering improved motion stability and visual quality compared to earlier iterations. | Parameter | Type | Required | Description | |---|---|---|---| | image | string | Yes | The URL of the input image. Supported formats include PNG, JPEG, JPG, WEBP, and BMP. File size must be between 0.0 MB and 10.0 MB. Image resolution must be between 300x300 and 2000x2000. Aspect ratio must be between 0.4:1 and 2.5:1. | | prompt | string | Yes | The text prompt describing the content to generate. Maximum string length: 800. | | resolution | string | No | Output resolution. Options: 480P, 720P, 1080P. Default is 480P. Allowed values: 480P, 720P, 1080P. | | duration | string | No | Video duration in seconds. Options: 5s, 10s. Default is 5s. Allowed values: 5s, 10s. | ##### Request Example ```json { "title": "Example Request", "request": [ { "title": "create video by text or image", "language": "cURL", "code_example": "curl --request POST \\\n --url https://openapi.media.io/generation/wan/i2v-wan-v2-5 \\\n --header 'Content-Type: application/json' \\\n --header 'X-API-KEY: ' \\\n --data '\n{\n \"data\": {\n \"duration\": \"5s\",\n \"image\": \"\",\n \"prompt\": \"\",\n \"resolution\": \"480P\"\n }\n}'\n" } ], "describe": "", "response": [ { "type": "200", "code_example": "{\n \"code\": 0,\n \"msg\": \"\",\n \"data\": {\n \"task_id\": \"\n },\n \"trace_id\": \"\n}" }, { "type": "default", "code_example": "{\n \"code\": ,\n \"msg\": ,\n \"data\": {},\n \"trace_id\": \"\n}" } ] } ``` ##### Response Example ```json { "list": [ { "name": "code", "type": "integer", "describe": "Response status code, 0 indicates success" }, { "name": "msg", "type": "string", "describe": "Response message, empty string on success" }, { "name": "data", "type": "object", "describe": "Response data object" }, { "name": "task_id", "type": "string", "describe": "Unique task identifier, located within the data object" }, { "name": "trace_id", "type": "string", "describe": "Request tracking ID" } ], "title": "Response", "describe": "After the request is successfully processed, the server will return the following response" } ``` ##### Skill.invoke Template ```python result = skill.invoke( 'Wan 2.5', { "image": "", "prompt": "", "resolution": "", "duration": "" }, api_key=api_key ) print(result) ``` #### Image To Video-12 Kling 2.6 (model_code: i2v-kling-v2-6) - API ID: 257 - Method: POST - Endpoint: https://openapi.media.io/generation/kling/i2v-kling-v2-6 - Description: Kling AI's video model, recognized for its ability to generate realistic and coherent motion. | Parameter | Type | Required | Description | |---|---|---|---| | image | string | Yes | The URL of the input image. Supported formats include PNG, JPEG, JPG, WEBP, GIF, and HEIC. File size must be between 0.0 MB and 20.0 MB. Image resolution must be between 300x300 and 4000x4000. Aspect ratio must be between 0.4:1 and 2.5:1. | | prompt | string | Yes | The text prompt describing the content to generate. Maximum string length: 2500. | | duration | string | No | Video duration in seconds. Options: 5s, 10s. Default is 5s. Allowed values: 5s, 10s. | | generate_audio | string | No | Generate Audio parameter. Options: True, False. Default is True. Allowed values: True, False. | ##### Request Example ```json { "title": "Example Request", "request": [ { "title": "create video by text or image", "language": "cURL", "code_example": "curl --request POST \\\n --url https://openapi.media.io/generation/kling/i2v-kling-v2-6 \\\n --header 'Content-Type: application/json' \\\n --header 'X-API-KEY: ' \\\n --data '\n{\n \"data\": {\n \"duration\": \"5s\",\n \"generate_audio\": \"True\",\n \"image\": \"\",\n \"prompt\": \"\"\n }\n}'\n" } ], "describe": "", "response": [ { "type": "200", "code_example": "{\n \"code\": 0,\n \"msg\": \"\",\n \"data\": {\n \"task_id\": \"\n },\n \"trace_id\": \"\n}" }, { "type": "default", "code_example": "{\n \"code\": ,\n \"msg\": ,\n \"data\": {},\n \"trace_id\": \"\n}" } ] } ``` ##### Response Example ```json { "list": [ { "name": "code", "type": "integer", "describe": "Response status code, 0 indicates success" }, { "name": "msg", "type": "string", "describe": "Response message, empty string on success" }, { "name": "data", "type": "object", "describe": "Response data object" }, { "name": "task_id", "type": "string", "describe": "Unique task identifier, located within the data object" }, { "name": "trace_id", "type": "string", "describe": "Request tracking ID" } ], "title": "Response", "describe": "After the request is successfully processed, the server will return the following response" } ``` ##### Skill.invoke Template ```python result = skill.invoke( 'Kling 2.6', { "image": "", "prompt": "", "duration": "", "generate_audio": "" }, api_key=api_key ) print(result) ``` #### Image To Video-13 Motion Control Kling 2.6 (model_code: i2v-motion-control-kling-v2-6) - API ID: 258 - Method: POST - Endpoint: https://openapi.media.io/generation/kling/i2v-motion-control-kling-v2-6 - Description: Offers advanced motion control and high realism, bridging the gap between standard and professional output. | Parameter | Type | Required | Description | |---|---|---|---| | video | string | Yes | The URL of the input video. Supported formats include MP4 and MOV. File size must be between 0.0 MB and 100.0 MB. Video resolution must be between 720x720 and 2160x2160. Frame rate must be between 24 and 60 FPS. Duration must be between 3 and 30 seconds. | | image | string | Yes | The URL of the input image. Supported formats include PNG, JPEG, and JPG. File size must be between 0.0 MB and 10.0 MB. Image resolution must be between 300x300 and 4000x4000. Aspect ratio must be between 1:2 and 2:1. | | prompt | string | No | The text prompt describing the content to generate. Maximum string length: 2500. | ##### Request Example ```json { "title": "Example Request", "request": [ { "title": "create video by text or image", "language": "cURL", "code_example": "curl --request POST \\\n --url https://openapi.media.io/generation/kling/i2v-motion-control-kling-v2-6 \\\n --header 'Content-Type: application/json' \\\n --header 'X-API-KEY: ' \\\n --data '\n{\n \"data\": {\n \"image\": \"\",\n \"prompt\": \"\",\n \"video\": \"\"\n }\n}'\n" } ], "describe": "", "response": [ { "type": "200", "code_example": "{\n \"code\": 0,\n \"msg\": \"\",\n \"data\": {\n \"task_id\": \"\n },\n \"trace_id\": \"\n}" }, { "type": "default", "code_example": "{\n \"code\": ,\n \"msg\": ,\n \"data\": {},\n \"trace_id\": \"\n}" } ] } ``` ##### Response Example ```json { "list": [ { "name": "code", "type": "integer", "describe": "Response status code, 0 indicates success" }, { "name": "msg", "type": "string", "describe": "Response message, empty string on success" }, { "name": "data", "type": "object", "describe": "Response data object" }, { "name": "task_id", "type": "string", "describe": "Unique task identifier, located within the data object" }, { "name": "trace_id", "type": "string", "describe": "Request tracking ID" } ], "title": "Response", "describe": "After the request is successfully processed, the server will return the following response" } ``` ##### Skill.invoke Template ```python result = skill.invoke( 'Motion Control Kling 2.6', { "video": "", "image": "", "prompt": "" }, api_key=api_key ) print(result) ``` #### Image To Video-14 Google Veo 3.1 Fast (model_code: i2v-veo-v3-1-fast) - API ID: 264 - Method: POST - Endpoint: https://openapi.media.io/generation/veo/i2v-veo-v3-1-fast - Description: Google Veo 3.1 Fast is an AI model for video generation. | Parameter | Type | Required | Description | |---|---|---|---| | image | string | Yes | The URL of the input image. Supported formats include JPG, JPEG, PNG, WEBP, GIF, and HEIC. File size must be between 0.0 MB and 50.0 MB. Image resolution must be between 300x300 and 4000x4000. Aspect ratio must be between 0.4:1 and 2:1. | | prompt | string | Yes | The text prompt describing the content to generate. Maximum string length: 1000. | | aspect_ratio | string | No | Target aspect ratio. Options: 9:16, 16:9. Default is 9:16. Allowed values: 9:16, 16:9. | | resolution | string | No | Output resolution. Options: 720P, 1080P. Default is 720P. Allowed values: 720P, 1080P. | | duration | string | No | Video duration in seconds. Options: 4s, 6s, 8s. Default is 4s. Allowed values: 4s, 6s, 8s. | | generate_audio | string | No | Generate Audio parameter. Options: True, False. Default is True. Allowed values: True, False. | ##### Request Example ```json { "title": "Example Request", "request": [ { "title": "create video by text or image", "language": "cURL", "code_example": "curl --request POST \\\n --url https://openapi.media.io/generation/veo/i2v-veo-v3-1-fast \\\n --header 'Content-Type: application/json' \\\n --header 'X-API-KEY: ' \\\n --data '\n{\n \"data\": {\n \"aspect_ratio\": \"9:16\",\n \"duration\": \"4s\",\n \"generate_audio\": \"True\",\n \"image\": \"\",\n \"prompt\": \"\",\n \"resolution\": \"720P\"\n }\n}'\n" } ], "describe": "", "response": [ { "type": "200", "code_example": "{\n \"code\": 0,\n \"msg\": \"\",\n \"data\": {\n \"task_id\": \"\n },\n \"trace_id\": \"\n}" }, { "type": "default", "code_example": "{\n \"code\": ,\n \"msg\": ,\n \"data\": {},\n \"trace_id\": \"\n}" } ] } ``` ##### Response Example ```json { "list": [ { "name": "code", "type": "integer", "describe": "Response status code, 0 indicates success" }, { "name": "msg", "type": "string", "describe": "Response message, empty string on success" }, { "name": "data", "type": "object", "describe": "Response data object" }, { "name": "task_id", "type": "string", "describe": "Unique task identifier, located within the data object" }, { "name": "trace_id", "type": "string", "describe": "Request tracking ID" } ], "title": "Response", "describe": "After the request is successfully processed, the server will return the following response" } ``` ##### Skill.invoke Template ```python result = skill.invoke( 'Google Veo 3.1 Fast', { "image": "", "prompt": "", "aspect_ratio": "", "resolution": "", "duration": "", "generate_audio": "" }, api_key=api_key ) print(result) ``` ### Text To Video #### Text To Video-1 Wan 2.6 (model_code: t2v-wan-v2-6) - API ID: 261 - Method: POST - Endpoint: https://openapi.media.io/generation/wan/t2v-wan-v2-6 - Description: Features advanced multi-shot storytelling and native audio-visual synchronization, ideal for creating complex narratives with consistent characters. | Parameter | Type | Required | Description | |---|---|---|---| | prompt | string | Yes | The text prompt describing the content to generate. Maximum string length: 1500. | | size | string | No | Output size. Options: 9:16, 16:9, 1:1, 4:3, 3:4. Default is 16:9. Allowed values: 9:16, 16:9, 1:1, 4:3, 3:4. | | duration | string | No | Video duration in seconds. Options: 5s, 10s, 15s. Default is 5s. Allowed values: 5s, 10s, 15s. | | shot_type | string | No | Shot Type parameter. Options: Multi, Single. Default is Multi. Allowed values: Multi, Single. | | generate_audio | string | No | Generate Audio parameter. Options: True, False. Default is True. Allowed values: True, False. | ##### Request Example ```json { "title": "Example Request", "request": [ { "title": "create video by text or image", "language": "cURL", "code_example": "curl --request POST \\\n --url https://openapi.media.io/generation/wan/t2v-wan-v2-6 \\\n --header 'Content-Type: application/json' \\\n --header 'X-API-KEY: ' \\\n --data '\n{\n \"data\": {\n \"duration\": \"5s\",\n \"generate_audio\": \"True\",\n \"prompt\": \"\",\n \"shot_type\": \"Multi\",\n \"size\": \"16:9\"\n }\n}'\n" } ], "describe": "", "response": [ { "type": "200", "code_example": "{\n \"code\": 0,\n \"msg\": \"\",\n \"data\": {\n \"task_id\": \"\n },\n \"trace_id\": \"\n}" }, { "type": "default", "code_example": "{\n \"code\": ,\n \"msg\": ,\n \"data\": {},\n \"trace_id\": \"\n}" } ] } ``` ##### Response Example ```json { "list": [ { "name": "code", "type": "integer", "describe": "Response status code, 0 indicates success" }, { "name": "msg", "type": "string", "describe": "Response message, empty string on success" }, { "name": "data", "type": "object", "describe": "Response data object" }, { "name": "task_id", "type": "string", "describe": "Unique task identifier, located within the data object" }, { "name": "trace_id", "type": "string", "describe": "Request tracking ID" } ], "title": "Response", "describe": "After the request is successfully processed, the server will return the following response" } ``` ##### Skill.invoke Template ```python result = skill.invoke( 'Wan 2.6', { "prompt": "", "size": "", "duration": "", "shot_type": "", "generate_audio": "" }, api_key=api_key ) print(result) ``` #### Text To Video-2 Vidu Q3 (model_code: t2v-vidu-q3) - API ID: 262 - Method: POST - Endpoint: https://openapi.media.io/generation/vidu/t2v-vidu-q3 - Description: The latest iteration optimized for superior speed and high-definition output, enabling rapid high-quality video creation. | Parameter | Type | Required | Description | |---|---|---|---| | prompt | string | Yes | The text prompt describing the content to generate. Maximum string length: 2000. | | ratio | string | No | Target aspect ratio. Options: 9:16, 16:9, 1:1, 4:3, 3:4. Default is 16:9. Allowed values: 9:16, 16:9, 1:1, 4:3, 3:4. | | resolution | string | No | Output resolution. Options: 540P, 720P, 1080P. Default is 720P. Allowed values: 540P, 720P, 1080P. | | duration | string | No | Video duration in seconds. Options: 4s, 8s, 12s, 16s. Default is 8s. Allowed values: 4s, 8s, 12s, 16s. | | generate_audio | string | No | Generate Audio parameter. Options: True, False. Default is True. Allowed values: True, False. | ##### Request Example ```json { "title": "Example Request", "request": [ { "title": "create video by text or image", "language": "cURL", "code_example": "curl --request POST \\\n --url https://openapi.media.io/generation/vidu/t2v-vidu-q3 \\\n --header 'Content-Type: application/json' \\\n --header 'X-API-KEY: ' \\\n --data '\n{\n \"data\": {\n \"duration\": \"8s\",\n \"generate_audio\": \"True\",\n \"prompt\": \"\",\n \"ratio\": \"16:9\",\n \"resolution\": \"720P\"\n }\n}'\n" } ], "describe": "", "response": [ { "type": "200", "code_example": "{\n \"code\": 0,\n \"msg\": \"\",\n \"data\": {\n \"task_id\": \"\n },\n \"trace_id\": \"\n}" }, { "type": "default", "code_example": "{\n \"code\": ,\n \"msg\": ,\n \"data\": {},\n \"trace_id\": \"\n}" } ] } ``` ##### Response Example ```json { "list": [ { "name": "code", "type": "integer", "describe": "Response status code, 0 indicates success" }, { "name": "msg", "type": "string", "describe": "Response message, empty string on success" }, { "name": "data", "type": "object", "describe": "Response data object" }, { "name": "task_id", "type": "string", "describe": "Unique task identifier, located within the data object" }, { "name": "trace_id", "type": "string", "describe": "Request tracking ID" } ], "title": "Response", "describe": "After the request is successfully processed, the server will return the following response" } ``` ##### Skill.invoke Template ```python result = skill.invoke( 'Vidu Q3', { "prompt": "", "ratio": "", "resolution": "", "duration": "", "generate_audio": "" }, api_key=api_key ) print(result) ``` #### Text To Video-3 Wan 2.5 (model_code: t2v-wan-v2-5) - API ID: 263 - Method: POST - Endpoint: https://openapi.media.io/generation/wan/t2v-wan-v2-5 - Description: An enhanced version offering improved motion stability and visual quality compared to earlier iterations. | Parameter | Type | Required | Description | |---|---|---|---| | prompt | string | Yes | The text prompt describing the content to generate. Maximum string length: 800. | | ratio | string | No | Target aspect ratio. Options: 16:9, 9:16, 1:1, 4:3, 3:4. Default is 16:9. Allowed values: 16:9, 9:16, 1:1, 4:3, 3:4. | | duration | string | No | Video duration in seconds. Options: 5s, 10s. Default is 5s. Allowed values: 5s, 10s. | ##### Request Example ```json { "title": "Example Request", "request": [ { "title": "create video by text or image", "language": "cURL", "code_example": "curl --request POST \\\n --url https://openapi.media.io/generation/wan/t2v-wan-v2-5 \\\n --header 'Content-Type: application/json' \\\n --header 'X-API-KEY: ' \\\n --data '\n{\n \"data\": {\n \"duration\": \"5s\",\n \"prompt\": \"\",\n \"ratio\": \"16:9\"\n }\n}'\n" } ], "describe": "", "response": [ { "type": "200", "code_example": "{\n \"code\": 0,\n \"msg\": \"\",\n \"data\": {\n \"task_id\": \"\n },\n \"trace_id\": \"\n}" }, { "type": "default", "code_example": "{\n \"code\": ,\n \"msg\": ,\n \"data\": {},\n \"trace_id\": \"\n}" } ] } ``` ##### Response Example ```json { "list": [ { "name": "code", "type": "integer", "describe": "Response status code, 0 indicates success" }, { "name": "msg", "type": "string", "describe": "Response message, empty string on success" }, { "name": "data", "type": "object", "describe": "Response data object" }, { "name": "task_id", "type": "string", "describe": "Unique task identifier, located within the data object" }, { "name": "trace_id", "type": "string", "describe": "Request tracking ID" } ], "title": "Response", "describe": "After the request is successfully processed, the server will return the following response" } ``` ##### Skill.invoke Template ```python result = skill.invoke( 'Wan 2.5', { "prompt": "", "ratio": "", "duration": "" }, api_key=api_key ) print(result) ``` ## 4. Recommended Runtime Templates ### 4.1 Text-to-Image Workflow (`Imagen 4` + `Task Result`) ```python import os import time from scripts.skill_router import Skill skill = Skill('scripts/c_api_doc_detail.json') api_key = os.getenv('API_KEY', '') create = skill.invoke('Imagen 4', { 'prompt': 'A cute kitten, photorealistic, soft natural light, highly detailed', 'ratio': '1:1', 'counts': '1' }, api_key=api_key) task_id = (create.get('data') or {}).get('task_id') for _ in range(24): r = skill.invoke('Task Result', {'task_id': task_id}, api_key=api_key) status = (r.get('data') or {}).get('status') if status in ('completed', 'succeeded', 'failed', 'timeout'): print(r) break time.sleep(5) ``` ## 5. Quick Reference (Minimum Viable Params) ### 5.1 Query APIs | API | Purpose | Minimum params | |---|---|---| | Credits | Query account credits | {} | | Task Result | Query task status/result | {"task_id": ""} | ### 5.2 Text To Image | API | Minimum params | |---|---| | Imagen 4 | {"prompt": ""} | | soul_character | {"prompt": ""} | ### 5.3 Image To Image | API | Minimum params | |---|---| | Nano Banana | {"images": "", "prompt": ""} | | Seedream 4.0 | {"images": "", "prompt": ""} | | Nano Banana Pro | {"images": "", "prompt": ""} | ### 5.4 Image To Video | API | Minimum params | |---|---| | Wan 2.6 | {"image": "", "prompt": ""} | | Wan 2.2 | {"image": "", "prompt": ""} | | Hailuo 02 | {"image": "", "prompt": ""} | | Kling 2.1 | {"image": "", "prompt": ""} | | Vidu Q3 | {"image": "", "prompt": ""} | | Kling 2.5 Turbo | {"image": "", "prompt": ""} | | Google Veo 3.1 | {"image": "", "prompt": ""} | | Kling 3.0 | {"image": "", "prompt": ""} | | Hailuo 2.3 | {"image": "", "prompt": ""} | | Vidu Q2 | {"image": "", "prompt": ""} | | Wan 2.5 | {"image": "", "prompt": ""} | | Kling 2.6 | {"image": "", "prompt": ""} | | Motion Control Kling 2.6 | {"video": "", "image": ""} | | Google Veo 3.1 Fast | {"image": "", "prompt": ""} | ### 5.5 Text To Video | API | Minimum params | |---|---| | Wan 2.6 | {"prompt": ""} | | Vidu Q3 | {"prompt": ""} | | Wan 2.5 | {"prompt": ""} | ## 6. Reusable Helper Snippets ### 6.1 Unified submit + poll function ```python import os import time from scripts.skill_router import Skill skill = Skill('scripts/c_api_doc_detail.json') api_key = os.getenv('API_KEY', '') def submit_and_wait(api_name, params, retries=36, interval_sec=5): create = skill.invoke(api_name, params, api_key=api_key) task_id = (create.get('data') or {}).get('task_id') if not task_id: return {'stage': 'create', 'response': create} for _ in range(retries): r = skill.invoke('Task Result', {'task_id': task_id}, api_key=api_key) status = (r.get('data') or {}).get('status') if status in ('completed', 'succeeded', 'failed', 'timeout'): return {'stage': 'result', 'task_id': task_id, 'response': r} time.sleep(interval_sec) return {'stage': 'timeout', 'task_id': task_id} ``` ### 6.2 Quick T2I call ```python r = submit_and_wait('Imagen 4', { 'prompt': 'A cute kitten, cinematic composition, soft daylight, ultra-detailed', 'ratio': '1:1', 'counts': '1' }) print(r) ``` ### 6.3 Quick I2V call ```python r = submit_and_wait('Kling 3.0', { 'image': 'https://example.com/input.jpg', 'prompt': 'Slow camera push-in, stable subject, cinematic lighting', 'duration': '5s', 'resolution': '1080P' }) print(r) ``` ## 7. Troubleshooting Checklist 1. `code=374004`: verify that `API_KEY` is configured and valid. 2. `code=490505`: your account is out of credits; recharge before retrying. 3. `API not found`: ensure `api_name` exactly matches the `name` field in API definitions. 4. Task remains `processing`: increase polling retries or reduce duration/resolution. 5. Missing `task_id`: check required parameters and payload shape against this document. FILE:scripts/c_api_doc_detail.json [ { "id": 196, "name": "Credits", "model_code": "user-credits", "method": "POST", "endpoint": "https://openapi.media.io/user/credits", "title": "User Credits API Documentation", "description": "API to query user credits balance.", "api_header": "{\"list\": [{\"name\": \"X-API-KEY\", \"value\": \"API key to authorize requests\"}, {\"name\": \"Content-Type\", \"value\": \"application/json\"}], \"title\": \"Authorizations\", \"describe\": \"Add the following authorization information in the request header\"}", "api_body": "{\"title\": \"Request Body\", \"category\": [{\"list\": [], \"title\": \"Query Credits\", \"describe\": \"Request body to query user credits balance\"}]}", "api_request_demo": "{\"title\": \"Example Request\", \"request\": [{\"title\": \"Query User Credits\", \"language\": \"cURL\", \"code_example\": \"curl --request POST \\n --url https://openapi.media.io/user/credits \\n --header 'Content-Type: application/json' \\n --header 'X-API-KEY: ' \\n --data '{}'\"}]}", "api_response": "{\"list\": [{\"name\": \"code\", \"type\": \"integer\", \"describe\": \"Response status code, 0 indicates success\"}, {\"name\": \"msg\", \"type\": \"string\", \"describe\": \"Response message, empty string on success\"}, {\"name\": \"data\", \"type\": \"object\", \"describe\": \"Response data object\"}, {\"name\": \"credits\", \"type\": \"integer\", \"describe\": \"User credits balance, located within the data object\"}], \"title\": \"Response\", \"describe\": \"After the request is successfully processed, the server will return the following response\"}", "api_code_demo": "{\"list\": [{\"code\": \"0\", \"describe\": \"Success\"}, {\"code\": \"40001\", \"describe\": \"Invalid API key\"}, {\"code\": \"40002\", \"describe\": \"API key expired\"}], \"title\": \"Status Code\"}", "content": null, "status": 1, "created_at": "3/3/2026 18:33:49", "updated_at": "3/3/2026 18:33:49" }, { "id": 197, "name": "Task Result", "model_code": "generation-result", "method": "POST", "endpoint": "https://openapi.media.io/generation/result/{task_id}", "title": "Task Result API Documentation", "description": "API to query generation task result by task ID.", "api_header": "{\"list\": [{\"name\": \"X-API-KEY\", \"value\": \"API key to authorize requests\"}, {\"name\": \"Content-Type\", \"value\": \"application/json\"}], \"title\": \"Authorizations\", \"describe\": \"Add the following authorization information in the request header\"}", "api_body": "{\"title\": \"Path Parameters\", \"category\": [{\"list\": [{\"name\": \"task_id\", \"type\": \"string\", \"describe\": \"The task ID to query, located in the URL path parameter\", \"required\": true}], \"title\": \"Query Task Result\", \"describe\": \"Request body to query task result\"}]}", "api_request_demo": "{\"title\": \"Example Request\", \"request\": [{\"title\": \"Query Task Result\", \"language\": \"cURL\", \"code_example\": \"curl --request POST \\n --url https://openapi.media.io/generation/result/ \\n --header 'Content-Type: application/json' \\n --header 'X-API-KEY: ' \\n --data '{}'\"}]}", "api_response": "{\"list\": [{\"name\": \"code\", \"type\": \"integer\", \"describe\": \"Response status code, 0 indicates success\"}, {\"name\": \"msg\", \"type\": \"string\", \"describe\": \"Response message, empty string on success\"}, {\"name\": \"data\", \"type\": \"object\", \"describe\": \"Response data object\"}, {\"name\": \"task_id\", \"type\": \"string\", \"describe\": \"Task identifier\"}, {\"name\": \"status\", \"type\": \"string\", \"describe\": \"Task status: pending, processing, succeeded, failed\"}, {\"name\": \"result\", \"type\": \"object\", \"describe\": \"Generation result when task succeeded\"}], \"title\": \"Response\", \"describe\": \"After the request is successfully processed, the server will return the following response\"}", "api_code_demo": "{\"list\": [{\"code\": \"0\", \"describe\": \"Success\"}, {\"code\": \"40001\", \"describe\": \"Invalid API key\"}, {\"code\": \"40002\", \"describe\": \"API key expired\"}, {\"code\": \"40003\", \"describe\": \"Task not found\"}], \"title\": \"Status Code\"}", "content": null, "status": 1, "created_at": "3/3/2026 18:33:49", "updated_at": "4/3/2026 21:30:23" }, { "id": 242, "name": "Nano Banana", "model_code": "i2i-banana", "method": "POST", "endpoint": "https://openapi.media.io/generation/banana/i2i-banana", "title": "Nano Banana API Documentation", "description": "Utilizes next-gen multimodal reasoning to generate images that perfectly align with nuanced conceptual descriptions.", "api_header": "{\"list\": [{\"name\": \"X-API-KEY\", \"value\": \"API key to authorize requests\"}, {\"name\": \"Content-Type\", \"value\": \"application/json\"}], \"title\": \"Authorizations\", \"describe\": \"Add the following authorization information in the request header\"}", "api_body": "{\"title\": \"Request Body\", \"category\": [{\"list\": [{\"name\": \"images\", \"type\": \"array\", \"describe\": \"The URLs of the input images. Supported formats include PNG, JPEG, and JPG. File size must be between 0.0 MB and 20.0 MB. Image resolution must be between 300x300 and 1280x1280. Aspect ratio must be between 1:2 and 2:1. Maximum 9 file(s).\", \"required\": true}, {\"name\": \"prompt\", \"type\": \"string\", \"describe\": \"The text prompt describing the content to generate. Maximum string length: 1200.\", \"required\": true}, {\"name\": \"ratio\", \"type\": \"string\", \"describe\": \"Target aspect ratio. Options: 9:16, 16:9, 1:1, 4:3, 3:4, 3:2, 2:3, 21:9. Default is 16:9.\", \"keywords\": [\"9:16\", \"16:9\", \"1:1\", \"4:3\", \"3:4\", \"3:2\", \"2:3\", \"21:9\"], \"required\": false}], \"title\": \"Image To Image\"}], \"describe\": \"The request body must contain the following parameters\"}", "api_request_demo": "{\"title\": \"Example Request\", \"request\": [{\"title\": \"create image by text or image\", \"language\": \"cURL\", \"code_example\": \"curl --request POST \\\\\\n --url https://openapi.media.io/generation/banana/i2i-banana \\\\\\n --header 'Content-Type: application/json' \\\\\\n --header 'X-API-KEY: ' \\\\\\n --data '\\n{\\n \\\"data\\\": {\\n \\\"images\\\": [\\n \\\"\\\"\\n ],\\n \\\"prompt\\\": \\\"\\\",\\n \\\"ratio\\\": \\\"16:9\\\"\\n }\\n}'\\n\"}], \"describe\": \"\", \"response\": [{\"type\": \"200\", \"code_example\": \"{\\n \\\"code\\\": 0,\\n \\\"msg\\\": \\\"\\\",\\n \\\"data\\\": {\\n \\\"task_id\\\": \\\"\\n },\\n \\\"trace_id\\\": \\\"\\n}\"}, {\"type\": \"default\", \"code_example\": \"{\\n \\\"code\\\": ,\\n \\\"msg\\\": ,\\n \\\"data\\\": {},\\n \\\"trace_id\\\": \\\"\\n}\"}]}", "api_response": "{\"list\": [{\"name\": \"code\", \"type\": \"integer\", \"describe\": \"Response status code, 0 indicates success\"}, {\"name\": \"msg\", \"type\": \"string\", \"describe\": \"Response message, empty string on success\"}, {\"name\": \"data\", \"type\": \"object\", \"describe\": \"Response data object\"}, {\"name\": \"task_id\", \"type\": \"string\", \"describe\": \"Unique task identifier, located within the data object\"}, {\"name\": \"trace_id\", \"type\": \"string\", \"describe\": \"Request tracking ID\"}], \"title\": \"Response\", \"describe\": \"After the request is successfully processed, the server will return the following response\"}", "api_code_demo": "{\"title\": \"Example Request\", \"request\": [{\"title\": \"create image by text or image\", \"language\": \"cURL\", \"code_example\": \"curl --request POST \\\\\\n --url https://openapi.media.io/generation/banana/i2i-banana \\\\\\n --header 'Content-Type: application/json' \\\\\\n --header 'X-API-KEY: ' \\\\\\n --data '\\n{\\n \\\"data\\\": {\\n \\\"images\\\": [\\n \\\"\\\"\\n ],\\n \\\"prompt\\\": \\\"\\\",\\n \\\"ratio\\\": \\\"16:9\\\"\\n }\\n}'\\n\"}], \"describe\": \"\", \"response\": [{\"type\": \"200\", \"code_example\": \"{\\n \\\"code\\\": 0,\\n \\\"msg\\\": \\\"\\\",\\n \\\"data\\\": {\\n \\\"task_id\\\": \\\"\\n },\\n \\\"trace_id\\\": \\\"\\n}\"}, {\"type\": \"default\", \"code_example\": \"{\\n \\\"code\\\": ,\\n \\\"msg\\\": ,\\n \\\"data\\\": {},\\n \\\"trace_id\\\": \\\"\\n}\"}]}", "content": null, "status": 1, "created_at": "4/3/2026 18:16:03", "updated_at": "6/3/2026 15:06:21" }, { "id": 243, "name": "Seedream 4.0", "model_code": "i2i-seedream-v4-0", "method": "POST", "endpoint": "https://openapi.media.io/generation/seedream/i2i-seedream-v4-0", "title": "Seedream 4.0 API Documentation", "description": "A versatile powerhouse supporting 4K generation and advanced editing, ensuring character and style consistency.", "api_header": "{\"list\": [{\"name\": \"X-API-KEY\", \"value\": \"API key to authorize requests\"}, {\"name\": \"Content-Type\", \"value\": \"application/json\"}], \"title\": \"Authorizations\", \"describe\": \"Add the following authorization information in the request header\"}", "api_body": "{\"title\": \"Request Body\", \"category\": [{\"list\": [{\"name\": \"images\", \"type\": \"array\", \"describe\": \"The URLs of the input images. Supported formats include PNG, JPEG, and JPG. File size must be between 0.0 MB and 10.0 MB. Image resolution must be between 300x300 and 1280x1280. Aspect ratio must be between 3:10 and 3:1. Maximum 9 file(s).\", \"required\": true}, {\"name\": \"prompt\", \"type\": \"string\", \"describe\": \"The text prompt describing the content to generate. Maximum string length: 800.\", \"required\": true}, {\"name\": \"ratio\", \"type\": \"string\", \"describe\": \"Target aspect ratio. Options: 9:16, 16:9, 1:1, 4:3, 3:4, 3:2, 2:3. Default is 9:16.\", \"keywords\": [\"9:16\", \"16:9\", \"1:1\", \"4:3\", \"3:4\", \"3:2\", \"2:3\"], \"required\": false}], \"title\": \"Image To Image\"}], \"describe\": \"The request body must contain the following parameters\"}", "api_request_demo": "{\"title\": \"Example Request\", \"request\": [{\"title\": \"create image by text or image\", \"language\": \"cURL\", \"code_example\": \"curl --request POST \\\\\\n --url https://openapi.media.io/generation/seedream/i2i-seedream-v4-0 \\\\\\n --header 'Content-Type: application/json' \\\\\\n --header 'X-API-KEY: ' \\\\\\n --data '\\n{\\n \\\"data\\\": {\\n \\\"images\\\": [\\n \\\"\\\"\\n ],\\n \\\"prompt\\\": \\\"\\\",\\n \\\"ratio\\\": \\\"9:16\\\"\\n }\\n}'\\n\"}], \"describe\": \"\", \"response\": [{\"type\": \"200\", \"code_example\": \"{\\n \\\"code\\\": 0,\\n \\\"msg\\\": \\\"\\\",\\n \\\"data\\\": {\\n \\\"task_id\\\": \\\"\\n },\\n \\\"trace_id\\\": \\\"\\n}\"}, {\"type\": \"default\", \"code_example\": \"{\\n \\\"code\\\": ,\\n \\\"msg\\\": ,\\n \\\"data\\\": {},\\n \\\"trace_id\\\": \\\"\\n}\"}]}", "api_response": "{\"list\": [{\"name\": \"code\", \"type\": \"integer\", \"describe\": \"Response status code, 0 indicates success\"}, {\"name\": \"msg\", \"type\": \"string\", \"describe\": \"Response message, empty string on success\"}, {\"name\": \"data\", \"type\": \"object\", \"describe\": \"Response data object\"}, {\"name\": \"task_id\", \"type\": \"string\", \"describe\": \"Unique task identifier, located within the data object\"}, {\"name\": \"trace_id\", \"type\": \"string\", \"describe\": \"Request tracking ID\"}], \"title\": \"Response\", \"describe\": \"After the request is successfully processed, the server will return the following response\"}", "api_code_demo": "{\"title\": \"Example Request\", \"request\": [{\"title\": \"create image by text or image\", \"language\": \"cURL\", \"code_example\": \"curl --request POST \\\\\\n --url https://openapi.media.io/generation/seedream/i2i-seedream-v4-0 \\\\\\n --header 'Content-Type: application/json' \\\\\\n --header 'X-API-KEY: ' \\\\\\n --data '\\n{\\n \\\"data\\\": {\\n \\\"images\\\": [\\n \\\"\\\"\\n ],\\n \\\"prompt\\\": \\\"\\\",\\n \\\"ratio\\\": \\\"9:16\\\"\\n }\\n}'\\n\"}], \"describe\": \"\", \"response\": [{\"type\": \"200\", \"code_example\": \"{\\n \\\"code\\\": 0,\\n \\\"msg\\\": \\\"\\\",\\n \\\"data\\\": {\\n \\\"task_id\\\": \\\"\\n },\\n \\\"trace_id\\\": \\\"\\n}\"}, {\"type\": \"default\", \"code_example\": \"{\\n \\\"code\\\": ,\\n \\\"msg\\\": ,\\n \\\"data\\\": {},\\n \\\"trace_id\\\": \\\"\\n}\"}]}", "content": null, "status": 1, "created_at": "4/3/2026 18:16:03", "updated_at": "6/3/2026 15:06:21" }, { "id": 244, "name": "Nano Banana Pro", "model_code": "i2i-banana-2", "method": "POST", "endpoint": "https://openapi.media.io/generation/banana/i2i-banana-2", "title": "Nano Banana Pro API Documentation", "description": "Utilizes next-gen multimodal reasoning to generate images that perfectly align with nuanced conceptual descriptions.", "api_header": "{\"list\": [{\"name\": \"X-API-KEY\", \"value\": \"API key to authorize requests\"}, {\"name\": \"Content-Type\", \"value\": \"application/json\"}], \"title\": \"Authorizations\", \"describe\": \"Add the following authorization information in the request header\"}", "api_body": "{\"title\": \"Request Body\", \"category\": [{\"list\": [{\"name\": \"images\", \"type\": \"array\", \"describe\": \"The URLs of the input images. Supported formats include PNG, JPEG, and JPG. File size must be between 0.0 MB and 20.0 MB. Image resolution must be between 300x300 and 1280x1280. Aspect ratio must be between 1:2 and 2:1. Maximum 9 file(s).\", \"required\": true}, {\"name\": \"prompt\", \"type\": \"string\", \"describe\": \"The text prompt describing the content to generate. Maximum string length: 1200.\", \"required\": true}, {\"name\": \"ratio\", \"type\": \"string\", \"describe\": \"Target aspect ratio. Options: 9:16, 16:9, 1:1, 4:3, 3:4, 3:2, 2:3, 21:9. Default is 16:9.\", \"keywords\": [\"9:16\", \"16:9\", \"1:1\", \"4:3\", \"3:4\", \"3:2\", \"2:3\", \"21:9\"], \"required\": false}, {\"name\": \"resolution\", \"type\": \"string\", \"describe\": \"Output resolution. Options: 1K, 2K, 4K. Default is 1K.\", \"keywords\": [\"1K\", \"2K\", \"4K\"], \"required\": false}], \"title\": \"Image To Image\"}], \"describe\": \"The request body must contain the following parameters\"}", "api_request_demo": "{\"title\": \"Example Request\", \"request\": [{\"title\": \"create image by text or image\", \"language\": \"cURL\", \"code_example\": \"curl --request POST \\\\\\n --url https://openapi.media.io/generation/banana/i2i-banana-2 \\\\\\n --header 'Content-Type: application/json' \\\\\\n --header 'X-API-KEY: ' \\\\\\n --data '\\n{\\n \\\"data\\\": {\\n \\\"images\\\": [\\n \\\"\\\"\\n ],\\n \\\"prompt\\\": \\\"\\\",\\n \\\"ratio\\\": \\\"16:9\\\",\\n \\\"resolution\\\": \\\"1K\\\"\\n }\\n}'\\n\"}], \"describe\": \"\", \"response\": [{\"type\": \"200\", \"code_example\": \"{\\n \\\"code\\\": 0,\\n \\\"msg\\\": \\\"\\\",\\n \\\"data\\\": {\\n \\\"task_id\\\": \\\"\\n },\\n \\\"trace_id\\\": \\\"\\n}\"}, {\"type\": \"default\", \"code_example\": \"{\\n \\\"code\\\": ,\\n \\\"msg\\\": ,\\n \\\"data\\\": {},\\n \\\"trace_id\\\": \\\"\\n}\"}]}", "api_response": "{\"list\": [{\"name\": \"code\", \"type\": \"integer\", \"describe\": \"Response status code, 0 indicates success\"}, {\"name\": \"msg\", \"type\": \"string\", \"describe\": \"Response message, empty string on success\"}, {\"name\": \"data\", \"type\": \"object\", \"describe\": \"Response data object\"}, {\"name\": \"task_id\", \"type\": \"string\", \"describe\": \"Unique task identifier, located within the data object\"}, {\"name\": \"trace_id\", \"type\": \"string\", \"describe\": \"Request tracking ID\"}], \"title\": \"Response\", \"describe\": \"After the request is successfully processed, the server will return the following response\"}", "api_code_demo": "{\"title\": \"Example Request\", \"request\": [{\"title\": \"create image by text or image\", \"language\": \"cURL\", \"code_example\": \"curl --request POST \\\\\\n --url https://openapi.media.io/generation/banana/i2i-banana-2 \\\\\\n --header 'Content-Type: application/json' \\\\\\n --header 'X-API-KEY: ' \\\\\\n --data '\\n{\\n \\\"data\\\": {\\n \\\"images\\\": [\\n \\\"\\\"\\n ],\\n \\\"prompt\\\": \\\"\\\",\\n \\\"ratio\\\": \\\"16:9\\\",\\n \\\"resolution\\\": \\\"1K\\\"\\n }\\n}'\\n\"}], \"describe\": \"\", \"response\": [{\"type\": \"200\", \"code_example\": \"{\\n \\\"code\\\": 0,\\n \\\"msg\\\": \\\"\\\",\\n \\\"data\\\": {\\n \\\"task_id\\\": \\\"\\n },\\n \\\"trace_id\\\": \\\"\\n}\"}, {\"type\": \"default\", \"code_example\": \"{\\n \\\"code\\\": ,\\n \\\"msg\\\": ,\\n \\\"data\\\": {},\\n \\\"trace_id\\\": \\\"\\n}\"}]}", "content": null, "status": 1, "created_at": "4/3/2026 18:16:03", "updated_at": "6/3/2026 15:06:21" }, { "id": 245, "name": "Wan 2.6", "model_code": "i2v-wan-v2-6", "method": "POST", "endpoint": "https://openapi.media.io/generation/wan/i2v-wan-v2-6", "title": "Wan 2.6 API Documentation", "description": "Features advanced multi-shot storytelling and native audio-visual synchronization, ideal for creating complex narratives with consistent characters.", "api_header": "{\"list\": [{\"name\": \"X-API-KEY\", \"value\": \"API key to authorize requests\"}, {\"name\": \"Content-Type\", \"value\": \"application/json\"}], \"title\": \"Authorizations\", \"describe\": \"Add the following authorization information in the request header\"}", "api_body": "{\"title\": \"Request Body\", \"category\": [{\"list\": [{\"name\": \"image\", \"type\": \"string\", \"describe\": \"The URL of the input image. Supported formats include PNG, JPEG, JPG, WEBP, and BMP. File size must be between 0.0 MB and 10.0 MB. Image resolution must be between 300x300 and 2000x2000. Aspect ratio must be between 0.4:1 and 2.5:1.\", \"required\": true}, {\"name\": \"prompt\", \"type\": \"string\", \"describe\": \"The text prompt describing the content to generate. Maximum string length: 1500.\", \"required\": true}, {\"name\": \"resolution\", \"type\": \"string\", \"describe\": \"Output resolution. Options: 720P, 1080P. Default is 720P.\", \"keywords\": [\"720P\", \"1080P\"], \"required\": false}, {\"name\": \"duration\", \"type\": \"string\", \"describe\": \"Video duration in seconds. Options: 5s, 10s, 15s. Default is 5s.\", \"keywords\": [\"5s\", \"10s\", \"15s\"], \"required\": false}, {\"name\": \"shot_type\", \"type\": \"string\", \"describe\": \"Shot Type parameter. Options: Multi, Single. Default is Multi.\", \"keywords\": [\"Multi\", \"Single\"], \"required\": false}, {\"name\": \"generate_audio\", \"type\": \"string\", \"describe\": \"Generate Audio parameter. Options: True, False. Default is True.\", \"keywords\": [\"True\", \"False\"], \"required\": false}], \"title\": \"Image To Video\"}], \"describe\": \"The request body must contain the following parameters\"}", "api_request_demo": "{\"title\": \"Example Request\", \"request\": [{\"title\": \"create video by text or image\", \"language\": \"cURL\", \"code_example\": \"curl --request POST \\\\\\n --url https://openapi.media.io/generation/wan/i2v-wan-v2-6 \\\\\\n --header 'Content-Type: application/json' \\\\\\n --header 'X-API-KEY: ' \\\\\\n --data '\\n{\\n \\\"data\\\": {\\n \\\"duration\\\": \\\"5s\\\",\\n \\\"generate_audio\\\": \\\"True\\\",\\n \\\"image\\\": \\\"\\\",\\n \\\"prompt\\\": \\\"\\\",\\n \\\"resolution\\\": \\\"720P\\\",\\n \\\"shot_type\\\": \\\"Multi\\\"\\n }\\n}'\\n\"}], \"describe\": \"\", \"response\": [{\"type\": \"200\", \"code_example\": \"{\\n \\\"code\\\": 0,\\n \\\"msg\\\": \\\"\\\",\\n \\\"data\\\": {\\n \\\"task_id\\\": \\\"\\n },\\n \\\"trace_id\\\": \\\"\\n}\"}, {\"type\": \"default\", \"code_example\": \"{\\n \\\"code\\\": ,\\n \\\"msg\\\": ,\\n \\\"data\\\": {},\\n \\\"trace_id\\\": \\\"\\n}\"}]}", "api_response": "{\"list\": [{\"name\": \"code\", \"type\": \"integer\", \"describe\": \"Response status code, 0 indicates success\"}, {\"name\": \"msg\", \"type\": \"string\", \"describe\": \"Response message, empty string on success\"}, {\"name\": \"data\", \"type\": \"object\", \"describe\": \"Response data object\"}, {\"name\": \"task_id\", \"type\": \"string\", \"describe\": \"Unique task identifier, located within the data object\"}, {\"name\": \"trace_id\", \"type\": \"string\", \"describe\": \"Request tracking ID\"}], \"title\": \"Response\", \"describe\": \"After the request is successfully processed, the server will return the following response\"}", "api_code_demo": "{\"title\": \"Example Request\", \"request\": [{\"title\": \"create video by text or image\", \"language\": \"cURL\", \"code_example\": \"curl --request POST \\\\\\n --url https://openapi.media.io/generation/wan/i2v-wan-v2-6 \\\\\\n --header 'Content-Type: application/json' \\\\\\n --header 'X-API-KEY: ' \\\\\\n --data '\\n{\\n \\\"data\\\": {\\n \\\"duration\\\": \\\"5s\\\",\\n \\\"generate_audio\\\": \\\"True\\\",\\n \\\"image\\\": \\\"\\\",\\n \\\"prompt\\\": \\\"\\\",\\n \\\"resolution\\\": \\\"720P\\\",\\n \\\"shot_type\\\": \\\"Multi\\\"\\n }\\n}'\\n\"}], \"describe\": \"\", \"response\": [{\"type\": \"200\", \"code_example\": \"{\\n \\\"code\\\": 0,\\n \\\"msg\\\": \\\"\\\",\\n \\\"data\\\": {\\n \\\"task_id\\\": \\\"\\n },\\n \\\"trace_id\\\": \\\"\\n}\"}, {\"type\": \"default\", \"code_example\": \"{\\n \\\"code\\\": ,\\n \\\"msg\\\": ,\\n \\\"data\\\": {},\\n \\\"trace_id\\\": \\\"\\n}\"}]}", "content": null, "status": 1, "created_at": "4/3/2026 18:16:03", "updated_at": "6/3/2026 15:02:49" }, { "id": 246, "name": "Wan 2.2", "model_code": "i2v-wan-v2-2", "method": "POST", "endpoint": "https://openapi.media.io/generation/wan/i2v-wan-v2-2", "title": "Wan 2.2 API Documentation", "description": "A balanced video generation model offering reliable motion quality and prompt adherence for general tasks.", "api_header": "{\"list\": [{\"name\": \"X-API-KEY\", \"value\": \"API key to authorize requests\"}, {\"name\": \"Content-Type\", \"value\": \"application/json\"}], \"title\": \"Authorizations\", \"describe\": \"Add the following authorization information in the request header\"}", "api_body": "{\"title\": \"Request Body\", \"category\": [{\"list\": [{\"name\": \"image\", \"type\": \"string\", \"describe\": \"The URL of the input image. Supported formats include PNG, JPEG, JPG, WEBP, and BMP. File size must be between 0.0 MB and 10.0 MB. Image resolution must be between 300x300 and 2000x2000. Aspect ratio must be between 0.4:1 and 2.5:1.\", \"required\": true}, {\"name\": \"prompt\", \"type\": \"string\", \"describe\": \"The text prompt describing the content to generate. Maximum string length: 800.\", \"required\": true}, {\"name\": \"resolution\", \"type\": \"string\", \"describe\": \"Output resolution. Options: 1080P. Default is 1080P.\", \"keywords\": [\"1080P\"], \"required\": false}, {\"name\": \"duration\", \"type\": \"string\", \"describe\": \"Video duration in seconds. Options: 5s. Default is 5s.\", \"keywords\": [\"5s\"], \"required\": false}], \"title\": \"Image To Video\"}], \"describe\": \"The request body must contain the following parameters\"}", "api_request_demo": "{\"title\": \"Example Request\", \"request\": [{\"title\": \"create video by text or image\", \"language\": \"cURL\", \"code_example\": \"curl --request POST \\\\\\n --url https://openapi.media.io/generation/wan/i2v-wan-v2-2 \\\\\\n --header 'Content-Type: application/json' \\\\\\n --header 'X-API-KEY: ' \\\\\\n --data '\\n{\\n \\\"data\\\": {\\n \\\"duration\\\": \\\"5s\\\",\\n \\\"image\\\": \\\"\\\",\\n \\\"prompt\\\": \\\"\\\",\\n \\\"resolution\\\": \\\"1080P\\\"\\n }\\n}'\\n\"}], \"describe\": \"\", \"response\": [{\"type\": \"200\", \"code_example\": \"{\\n \\\"code\\\": 0,\\n \\\"msg\\\": \\\"\\\",\\n \\\"data\\\": {\\n \\\"task_id\\\": \\\"\\n },\\n \\\"trace_id\\\": \\\"\\n}\"}, {\"type\": \"default\", \"code_example\": \"{\\n \\\"code\\\": ,\\n \\\"msg\\\": ,\\n \\\"data\\\": {},\\n \\\"trace_id\\\": \\\"\\n}\"}]}", "api_response": "{\"list\": [{\"name\": \"code\", \"type\": \"integer\", \"describe\": \"Response status code, 0 indicates success\"}, {\"name\": \"msg\", \"type\": \"string\", \"describe\": \"Response message, empty string on success\"}, {\"name\": \"data\", \"type\": \"object\", \"describe\": \"Response data object\"}, {\"name\": \"task_id\", \"type\": \"string\", \"describe\": \"Unique task identifier, located within the data object\"}, {\"name\": \"trace_id\", \"type\": \"string\", \"describe\": \"Request tracking ID\"}], \"title\": \"Response\", \"describe\": \"After the request is successfully processed, the server will return the following response\"}", "api_code_demo": "{\"title\": \"Example Request\", \"request\": [{\"title\": \"create video by text or image\", \"language\": \"cURL\", \"code_example\": \"curl --request POST \\\\\\n --url https://openapi.media.io/generation/wan/i2v-wan-v2-2 \\\\\\n --header 'Content-Type: application/json' \\\\\\n --header 'X-API-KEY: ' \\\\\\n --data '\\n{\\n \\\"data\\\": {\\n \\\"duration\\\": \\\"5s\\\",\\n \\\"image\\\": \\\"\\\",\\n \\\"prompt\\\": \\\"\\\",\\n \\\"resolution\\\": \\\"1080P\\\"\\n }\\n}'\\n\"}], \"describe\": \"\", \"response\": [{\"type\": \"200\", \"code_example\": \"{\\n \\\"code\\\": 0,\\n \\\"msg\\\": \\\"\\\",\\n \\\"data\\\": {\\n \\\"task_id\\\": \\\"\\n },\\n \\\"trace_id\\\": \\\"\\n}\"}, {\"type\": \"default\", \"code_example\": \"{\\n \\\"code\\\": ,\\n \\\"msg\\\": ,\\n \\\"data\\\": {},\\n \\\"trace_id\\\": \\\"\\n}\"}]}", "content": null, "status": 1, "created_at": "4/3/2026 18:16:03", "updated_at": "6/3/2026 15:02:49" }, { "id": 247, "name": "Hailuo 02", "model_code": "i2v-minimax-02", "method": "POST", "endpoint": "https://openapi.media.io/generation/minimax/i2v-minimax-02", "title": "Hailuo 02 API Documentation", "description": "Excels in cinematic realism and complex physics simulation, offering 'Director-level' control over camera movements and high fidelity.", "api_header": "{\"list\": [{\"name\": \"X-API-KEY\", \"value\": \"API key to authorize requests\"}, {\"name\": \"Content-Type\", \"value\": \"application/json\"}], \"title\": \"Authorizations\", \"describe\": \"Add the following authorization information in the request header\"}", "api_body": "{\"title\": \"Request Body\", \"category\": [{\"list\": [{\"name\": \"image\", \"type\": \"string\", \"describe\": \"The URL of the input image. Supported formats include PNG, JPEG, JPG, WEBP, GIF, and HEIC. File size must be between 0.0 MB and 20.0 MB. Image resolution must be between 300x300 and 4000x4000. Aspect ratio must be between 0.4:1 and 2.5:1.\", \"required\": true}, {\"name\": \"prompt\", \"type\": \"string\", \"describe\": \"The text prompt describing the content to generate. Maximum string length: 2000.\", \"required\": true}, {\"name\": \"duration\", \"type\": \"string\", \"describe\": \"Video duration in seconds. Options: 6s. Default is 6s.\", \"keywords\": [\"6s\"], \"required\": false}, {\"name\": \"resolution\", \"type\": \"string\", \"describe\": \"Output resolution. Options: 768P, 1080P. Default is 768P.\", \"keywords\": [\"768P\", \"1080P\"], \"required\": false}], \"title\": \"Image To Video\"}], \"describe\": \"The request body must contain the following parameters\"}", "api_request_demo": "{\"title\": \"Example Request\", \"request\": [{\"title\": \"create video by text or image\", \"language\": \"cURL\", \"code_example\": \"curl --request POST \\\\\\n --url https://openapi.media.io/generation/minimax/i2v-minimax-02 \\\\\\n --header 'Content-Type: application/json' \\\\\\n --header 'X-API-KEY: ' \\\\\\n --data '\\n{\\n \\\"data\\\": {\\n \\\"duration\\\": \\\"6s\\\",\\n \\\"image\\\": \\\"

Media.io AI Image & Video Generation API

Comments (0)