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 নিয়ে সাহায্য দরকার?