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
- 💬 ஆதரவைத் தொடர்பு கொள்ளுங்கள்