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 తో సహాయం కావాలా?