Veo3 Text-to-Video

Tool Overview

The Veo3 Text-to-Video tool uses Google's Veo3 model to generate high-quality video content from text descriptions. It supports multiple aspect ratios and is suitable for creating video materials for various scenarios.

Tool Identifier

veo3-text-to-video-fast-api

Parameters

Required Parameters

prompt

Type: string (required)
Description: Text description of the video content to guide AI video generation
Validation: Must be a non-empty string
Example: "A serene sunset over the ocean with waves gently crashing on the shore"

Optional Parameters

aspect_ratio

Type: string (optional)
Default: "16:9"
Supported Values:
- "16:9" - Landscape format, suitable for YouTube, TV, and other platforms
- "9:16" - Portrait format, suitable for TikTok, Instagram Story, and other platforms
Note: If any other value is provided, it will automatically default to "16:9"

Pricing

Credits Consumed: 420 credits per task
Membership Requirement: None

Request Examples

Landscape Video (16:9)

curl -X POST https://sjinn.ai/api/un-api/create_tool_task \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "tool_type": "veo3-text-to-video-fast-api",
    "input": {
      "prompt": "A majestic dragon flying through clouds at sunset, cinematic lighting",
      "aspect_ratio": "16:9"
    }
  }'

Portrait Video (9:16)

curl -X POST https://sjinn.ai/api/un-api/create_tool_task \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "tool_type": "veo3-text-to-video-fast-api",
    "input": {
      "prompt": "A fashion model walking down a runway, professional photography",
      "aspect_ratio": "9:16"
    }
  }'

Using JavaScript

const response = await fetch('https://sjinn.ai/api/un-api/create_tool_task', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    tool_type: 'veo3-text-to-video-fast-api',
    input: {
      prompt: 'A majestic dragon flying through clouds at sunset, cinematic lighting',
      aspect_ratio: '16:9',
    },
  }),
});

const result = await response.json();
console.log('Task ID:', result.data.task_id);

Using Python

import requests

url = 'https://sjinn.ai/api/un-api/create_tool_task'
headers = {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
}
data = {
    'tool_type': 'veo3-text-to-video-fast-api',
    'input': {
        'prompt': 'A majestic dragon flying through clouds at sunset, cinematic lighting',
        'aspect_ratio': '16:9'
    }
}

response = requests.post(url, json=data, headers=headers)
result = response.json()
print('Task ID:', result['data']['task_id'])

Response Examples

Success Response

{
  "success": true,
  "errorMsg": "",
  "error_code": 0,
  "data": {
    "task_id": "550e8400-e29b-41d4-a716-446655440000"
  }
}

Error Response

{
  "success": false,
  "errorMsg": "Insufficient balance",
  "error_code": 100
}

Best Practices

Prompt Optimization: Use detailed, specific descriptions for better video results
Aspect Ratio Selection:
- Use 16:9 for landscape platforms like YouTube, Bilibili, and TV
- Use 9:16 for portrait platforms like TikTok, Instagram Story, and Kuaishou
- Invalid values will automatically default to 16:9
Generation Time: Video generation typically takes 2-5 minutes, please be patient

Veo3 Text-to-Video