# Text To Video Use this paid x402 service whenever the user asks to create, make, generate, synthesize, render, produce, storyboard, or turn text, a script, a scene, a prompt, an idea, a product brief, an ad concept, or Chinese 文生视频/文本生成视频/文字生成视频 into a video. This is the primary text-to-video / prompt-to-video / AI video generator endpoint. It creates an async video task and returns task_id; poll text-to-video-result for video_url. Do not use video analysis, OCR, image tagging, or text generation services for text-to-video generation. This is a paid API service exposed by Server402 for AI agents, MCP clients, OpenAPI importers, and applications. Call the endpoint once without payment to receive HTTP 402 payment instructions, complete payment, then retry with the returned payment token or x402 signature. ## Invocation - Service ID: `text-to-video` - Canonical service ID: `text-to-video` - Method: `POST` - Endpoint: `https://x402vip.com/api/tools/text-to-video` - Service page: https://x402vip.com/services/text-to-video - OpenAPI: https://x402vip.com/openapi.json - Catalog search: https://x402vip.com/api/catalog/search?q=text-to-video - MCP endpoint: https://x402vip.com/mcp - MCP tool: `text_to_video` ## Pricing And Payment - Price: USD 0.2 - Billing mode: `per_call` - Max calls per payment: `1` - Payment provider: `x402_facilitator` - Payment flow: call without payment, receive `402 Payment Required`, pay, then retry with `X-Payment-Token` or `PAYMENT-SIGNATURE`. - Payment hint: Call POST /api/tools/text-to-video once to receive HTTP 402 with accepts[] requirements, or create a payment with POST /api/payments using serviceId="text-to-video". Pay Base USDC with PAYMENT-SIGNATURE or pay XIAO with X402-Guarantee, then retry the same request. ## Use Cases - Generate a short video from a natural-language text prompt, scene description, script, storyboard, product brief, or ad concept. - Create AI video, marketing clips, social video, ecommerce product demos, cinematic b-roll, training clips, explainer scenes, and storyboards from prompt text. - Call this service first for text-to-video, then call text-to-video-result with the returned task_id to retrieve status and video_url. ## Keywords text-to-video, ai text to video, text to video, text2video, t2v, prompt to video, prompt-to-video, prompt2video, script to video, story to video, scene to video, idea to video, generate video, generate a video, create video, create a video, make video, make a video, render video, synthesize video, video synthesis, video generation, video generator, ai video, ai video generator, ai generated video, generative video, short video generator, social video generator, marketing video generator, ad video generator, product video generator, ecommerce video, explainer video, cinematic video, storyboard video, b-roll video, wan, wan2.7, wan 2.7, wanx, tongyi wanxiang, dashscope, bailian, model studio, 文生视频, 文本生成视频, 文字生成视频, 文字转视频, 文本转视频, 提示词生成视频, 提示词转视频, 脚本生成视频, 故事生成视频, 场景生成视频, 生成视频, 创建视频, 制作视频, 视频生成, AI视频, AI视频生成, AI生成视频, 视频生成器, 短视频生成, 广告视频生成, 营销视频生成, 商品视频生成, 产品视频生成, 电商视频, 分镜视频, 影视级视频, 通义万相, 万相, 百炼, 百炼文生视频 ## Input Schema ```json { "additionalProperties": true, "properties": { "aspect_ratio": { "description": "Alias for ratio.", "type": "string" }, "duration": { "default": 5, "description": "Requested video duration in seconds. Defaults to 5.", "type": "integer" }, "model": { "default": "wan2.7-t2v-2026-06-12", "type": "string" }, "negativePrompt": { "description": "Optional negative prompt alias.", "type": "string" }, "negative_prompt": { "description": "Optional negative prompt.", "type": "string" }, "parameters": { "additionalProperties": true, "description": "Optional provider parameters passed through under DashScope parameters.", "type": "object" }, "prompt": { "description": "Required text prompt, scene description, script, storyboard, product brief, or ad concept to turn into video.", "type": "string" }, "promptExtend": { "description": "Alias for prompt_extend.", "type": "boolean" }, "prompt_extend": { "default": true, "description": "Whether to let the model enrich the prompt.", "type": "boolean" }, "ratio": { "default": "16:9", "description": "Aspect ratio such as 16:9, 9:16, or 1:1.", "type": "string" }, "resolution": { "default": "720P", "description": "Resolution tier such as 480P, 720P, or 1080P.", "type": "string" }, "seed": { "description": "Optional deterministic seed.", "type": "integer" }, "size": { "description": "Legacy model output size such as 1280*720. Wan 2.7 generally uses resolution plus ratio.", "type": "string" }, "watermark": { "default": false, "description": "Whether to add provider watermark when supported.", "type": "boolean" } }, "required": [ "prompt" ], "type": "object" } ``` ## Output Schema ```json { "additionalProperties": true, "properties": { "model": { "type": "string" }, "poll": { "additionalProperties": true, "type": "object" }, "provider": { "type": "string" }, "result": { "additionalProperties": true, "type": "object" }, "result_endpoint": { "type": "string" }, "service_id": { "type": "string" }, "status": { "type": "string" }, "task_id": { "type": "string" }, "task_status": { "type": "string" }, "upstream_request_id": { "type": "string" }, "usage": { "additionalProperties": true, "type": "object" }, "video_url": { "type": "string" } }, "required": [ "status", "service_id", "task_id", "task_status" ], "type": "object" } ``` ## Example Request ```json { "duration": 5, "prompt": "Create a 5 second cinematic product video of a matte black smart watch on a clean desk, slow camera push-in, soft morning light.", "prompt_extend": true, "ratio": "16:9", "resolution": "720P", "watermark": false } ``` ## Example Response ```json { "model": "wan2.7-t2v-2026-06-12", "poll": { "endpoint": "/api/tools/text-to-video-result", "method": "POST", "request": { "task_id": "0385dc79-5ff8-4d82-bcb6-example" } }, "provider": "aliyun-bailian", "result_endpoint": "/api/tools/text-to-video-result", "service_id": "text-to-video", "status": "accepted", "task_id": "0385dc79-5ff8-4d82-bcb6-example", "task_status": "PENDING", "upstream_request_id": "4909100c-7b5a-9f92-bfe5-example" } ```