API குறிப்பு

Veo 3.1 AI வீடியோ உருவாக்கத்திற்கான முழுமையான API ஆவணங்கள்

கண்ணோட்டம்

Veo 3.1 API உரை விளக்கங்கள் அல்லது படங்களிலிருந்து நிரல்ரீதியாக AI வீடியோக்களை உருவாக்க உங்களை அனுமதிக்கிறது. எங்கள் RESTful API எளிமையானதாகவும், சக்திவாய்ந்ததாகவும், உங்கள் பயன்பாடுகளில் எளிதாக ஒருங்கிணைக்கக்கூடியதாகவும் வடிவமைக்கப்பட்டுள்ளது.

அடிப்படை URL

https://veo3o1.com/api

அங்கீகாரம்

அனைத்து API கோரிக்கைகளுக்கும் API விசையைப் பயன்படுத்தி அங்கீகாரம் தேவை. உங்கள் API விசையை Authorization தலைப்பில் சேர்க்கவும்:

Authorization: Bearer YOUR_API_KEY

உங்கள் கணக்கு டாஷ்போர்டில் இருந்து API விசைகளை உருவாக்கலாம்.


வீடியோ உருவாக்கு

உரை அல்லது படத்திலிருந்து புதிய AI வீடியோவை உருவாக்குங்கள்.

எண்ட்பாயிண்ட்

POST /generate-video

கோரிக்கை உடல்

{
  "generationType": "text_to_video" | "image_to_video",
  "prompt": "Your video description",
  "aspectRatio": "auto" | "16:9" | "9:16",
  "imageUrl": "https://...", // Required if generationType is "image_to_video"
  "imageKey": "r2-key" // Optional, for uploaded images
}

அளவுருக்கள்

அளவுருவகைதேவைவிளக்கம்
generationTypestringஆம்உருவாக்க வகை: text_to_video அல்லது image_to_video
promptstringஆம்நீங்கள் உருவாக்க விரும்பும் வீடியோவின் விளக்கம்
aspectRatiostringஇல்லைவீடியோ விகிதம். இயல்புநிலை: auto
imageUrlstringநிபந்தனைgenerationType image_to_video எனில் தேவை
imageKeystringஇல்லைபதிவேற்றிய படங்களுக்கான சேமிப்பு விசை

பதில்

{
  "code": 0,
  "msg": "Success",
  "data": {
    "uuid": "video-uuid-123",
    "status": "pending",
    "generationType": "text_to_video",
    "prompt": "Your video description",
    "aspectRatio": "16:9",
    "createdAt": "2025-10-16T10:00:00Z"
  }
}

எடுத்துக்காட்டு

curl -X POST https://veo3o1.com/api/generate-video \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "generationType": "text_to_video",
    "prompt": "A beautiful sunset over the ocean with waves gently lapping the shore",
    "aspectRatio": "16:9"
  }'

வீடியோ நிலையைப் பெறுங்கள்

வீடியோ உருவாக்க கோரிக்கையின் நிலையைச் சரிபார்க்கவும்.

எண்ட்பாயிண்ட்

GET /video-status/{uuid}

அளவுருக்கள்

அளவுருவகைதேவைவிளக்கம்
uuidstringஆம்உருவாக்க கோரிக்கையிலிருந்து வீடியோ UUID

பதில்

{
  "code": 0,
  "msg": "Success",
  "data": {
    "uuid": "video-uuid-123",
    "status": "completed" | "pending" | "processing" | "failed",
    "videoUrl": "https://...", // Available when status is "completed"
    "progress": 85, // Processing progress (0-100)
    "estimatedTime": 120 // Estimated seconds remaining
  }
}

நிலை மதிப்புகள்

  • pending: வீடியோ செயலாக்கத்திற்கு வரிசையில் உள்ளது
  • processing: வீடியோ உருவாக்கப்படுகிறது
  • completed: வீடியோ தயாராக உள்ளது மற்றும் பதிவிறக்கத்திற்கு கிடைக்கிறது
  • failed: உருவாக்கம் தோல்வியடைந்தது (பிழை செய்தியைச் சரிபார்க்கவும்)

படம் பதிவேற்றவும்

படத்திலிருந்து வீடியோ உருவாக்கத்திற்கு படத்தைப் பதிவேற்றவும்.

எண்ட்பாயிண்ட்

POST /upload-video-image

கோரிக்கை

படக் கோப்பைப் பதிவேற்ற multipart/form-data பயன்படுத்தவும்.

curl -X POST https://veo3o1.com/api/upload-video-image \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@/path/to/image.jpg"

பதில்

{
  "code": 0,
  "msg": "Upload successful",
  "data": {
    "imageUrl": "https://...",
    "imageKey": "r2-key-123"
  }
}

ஆதரிக்கப்படும் வடிவங்கள்

  • JPEG/JPG
  • PNG
  • WebP
  • அதிகபட்ச கோப்பு அளவு: 50MB

பிழை குறியீடுகள்

குறியீடுவிளக்கம்
0வெற்றி
1000தவறான அளவுருக்கள்
1001போதுமான கிரெடிட்கள் இல்லை
1002அங்கீகாரம் தோல்வியடைந்தது
1003வேக வரம்பு மீறப்பட்டது
5000சேவையக பிழை

பிழை பதில் எடுத்துக்காட்டு

{
  "code": 1001,
  "msg": "Insufficient credits",
  "data": {
    "required": 2,
    "current": 0
  }
}

சிறந்த நடைமுறைகள்

  1. பொறுப்பான போலிங்: வீடியோ நிலையை ஒவ்வொரு 5-10 வினாடிகளுக்கும் சரிபார்க்கவும், தொடர்ச்சியாக அல்ல
  2. பிழை கையாளுதல்: அதிவேக பின்வாங்கலுடன் மறுமுயற்சி தர்க்கத்தை செயல்படுத்தவும்
  3. முடிவுகளை தற்காலிகமாக சேமிக்கவும்: மீண்டும் உருவாக்குவதைத் தவிர்க்க உருவாக்கப்பட்ட வீடியோக்களை சேமிக்கவும்
  4. Webhooks பயன்படுத்தவும்: நிறைவு அறிவிப்புகளுக்கு போலிங்கை விட திறமையானது
  5. உள்ளீடுகளை சரிபார்க்கவும்: API அழைப்புகளுக்கு முன் ப்ராம்ப்ட் நீளம் மற்றும் பட வடிவங்களை சரிபார்க்கவும்

ஆதரவு

API உடன் உதவி தேவையா?