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
}పారామీటర్లు
| పారామీటర్ | టైప్ | అవసరం | వివరణ |
|---|---|---|---|
generationType | string | అవును | జనరేషన్ టైప్: text_to_video లేదా image_to_video |
prompt | string | అవును | మీరు జనరేట్ చేయాలనుకుంటున్న వీడియో వివరణ |
aspectRatio | string | కాదు | వీడియో ఆస్పెక్ట్ రేషియో. డిఫాల్ట్: auto |
imageUrl | string | షరతులతో | generationType image_to_video అయితే అవసరం |
imageKey | string | కాదు | అప్లోడ్ చేసిన ఇమేజ్ల కోసం స్టోరేజ్ కీ |
రెస్పాన్స్
{
"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}పారామీటర్లు
| పారామీటర్ | టైప్ | అవసరం | వివరణ |
|---|---|---|---|
uuid | string | అవును | జనరేషన్ రిక్వెస్ట్ నుండి వీడియో 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
}
}బెస్ట్ ప్రాక్టీసెస్
- బాధ్యతాయుతమైన పోలింగ్: వీడియో స్టేటస్ను ప్రతి 5-10 సెకన్లకు చెక్ చేయండి, నిరంతరం కాదు
- ఎర్రర్ హ్యాండ్లింగ్: ఎక్స్పోనెన్షియల్ బ్యాక్ఆఫ్తో రీట్రై లాజిక్ అమలు చేయండి
- ఫలితాలను కాష్ చేయండి: రీజనరేషన్ నివారించడానికి జనరేట్ చేసిన వీడియోలను స్టోర్ చేయండి
- Webhooks ఉపయోగించండి: కంప్లీషన్ నోటిఫికేషన్లకు పోలింగ్ కంటే మరింత సమర్థవంతం
- ఇన్పుట్లను వాలిడేట్ చేయండి: API కాల్స్ ముందు ప్రాంప్ట్ పొడవు మరియు ఇమేజ్ ఫార్మాట్లను చెక్ చేయండి
సపోర్ట్
API తో సహాయం కావాలా?
- 📧 ఇమెయిల్: aiprocessingrobot@gmail.com
- 💬 సపోర్ట్ను సంప్రదించండి