Google Veo3 Ultra

Model pembuatan video terbaru dari Google dengan realisme luar biasa dan akurasi fisik.

Autentikasi

Untuk mengakses Google Veo3 melalui API Doitong, gunakan kunci API Doitong Anda. Sertakan kunci tersebut dalam mutasi GraphQL atau header REST API.

// GraphQL Header
{
  "Authorization": "Bearer YOUR_API_KEY"
}

// REST Header
"X-API-Key": "YOUR_API_KEY"

Memulai Cepat

Mulai gunakan Veo-3 API hanya dalam beberapa menit. Ikuti langkah-langkah sederhana ini untuk membuat text to video pertama Anda.

Langkah 1: Dapatkan Kunci API Anda

Daftar akun Doitong dan buka dasbor Anda untuk membuat kunci API.

Langkah 2: Buat Permintaan Pertama Anda

Gunakan salah satu contoh kode di bawah ini untuk melakukan panggilan API pertama Anda.

curl -X POST https://api.doitong.com/graphql \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Idempotency-Key: unique-request-id-123" \
  -d '{
    "query": "mutation Generate($input: GenerateInput!) { generate(input: $input) { id status type provider url metadata creditCost } }",
    "variables": {
      "input": {
        "type": "VIDEO",
        "provider": "veo3",
        "input": {
          "text": "A serene landscape with mountains and a lake at sunset"
        },
        "options": {
          "duration": 5,
          "aspectRatio": "16:9"
        }
      }
    }
  }'

const response = await fetch('https://api.doitong.com/graphql', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer YOUR_API_KEY',
    'Idempotency-Key': 'unique-request-id-123'
  },
  body: JSON.stringify({
    query: `
      mutation Generate($input: GenerateInput!) {
        generate(input: $input) {
          id
          status
          type
          provider
          url
          metadata
          creditCost
        }
      }
    `,
    variables: {
      input: {
        type: 'VIDEO',
        provider: 'veo3',
        input: {
          text: 'A serene landscape with mountains and a lake at sunset'
        },
        options: {
          duration: 5,
          aspectRatio: '16:9'
        }
      }
    }
  })
});

const data = await response.json();
console.log('Result:', data.data.generate);

import requests
import json

url = "https://api.doitong.com/graphql"
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_API_KEY"
}

query = """
mutation Generate($input: GenerateInput!) {
  generate(input: $input) {
    id
    status
    type
    provider
    url
    metadata
    creditCost
  }
}
"""

variables = {
    "input": {
        "type": "VIDEO",
        "provider": "veo3",
        "input": {
            "text": "A serene landscape with mountains and a lake at sunset"
        },
        "options": {
            "duration": 5,
            "aspectRatio": "16:9"
        }
    }
}

response = requests.post(url, json={
    "query": query,
    "variables": variables
}, headers=headers)

data = response.json()
print("Result:", data["data"]["generate"])

mutation Generate($input: GenerateInput!) {
  generate(input: $input) {
    id
    status
    type
    provider
    url
    metadata
    creditCost
    createdAt
  }
}

# Variables
{
  "input": {
    "type": "VIDEO",
    "provider": "veo3",
    "input": {
      "text": "A serene landscape with mountains and a lake at sunset"
    },
    "options": {
      "duration": 5,
      "aspectRatio": "16:9",
      "version": "veo-3",
      "quality": "high"
    }
  }
}

Harga

Veo-3 API menggunakan model harga berbasis kredit. Kredit digunakan berdasarkan kompleksitas dan durasi konten yang dihasilkan.

Endpoint API

Veo-3 API tersedia melalui endpoint GraphQL terpadu kami.

Endpoint GraphQL

POST https://api.doitong.com/graphql

Endpoint REST

POST https://api.doitong.com/v1/text_to_video

Parameter

Parameter yang tersedia untuk permintaan Veo-3 API:

Format Respons

Semua respons API mengikuti format yang konsisten:

Respons Berhasil

{
  "data": {
    "generatevideo": {
      "id": "abc123xyz",
      "status": "processing",
      "url": null,
      "webhookUrl": "https://your-webhook.com/callback",
      "createdAt": "2024-01-01T00:00:00Z"
    }
  }
}

Respons Selesai

{
  "data": {
    "generatevideo": {
      "id": "abc123xyz",
      "status": "completed",
      "url": "https://cdn.doitong.com/outputs/abc123xyz.mp4",
      "duration": 5,
      "createdAt": "2024-01-01T00:00:00Z"
    }
  }
}

Penanganan Error

API menggunakan kode status HTTP standar dan mengembalikan pesan error yang mendetail.

Kode Error Umum

Format Respons Error

{
  "errors": [
    {
      "message": "Insufficient credits for this operation",
      "extensions": {
        "code": "INSUFFICIENT_CREDITS",
        "creditsRequired": 100,
        "creditsAvailable": 50
      }
    }
  ]
}

Webhook

Terima notifikasi real-time saat pembuatan text to video Anda selesai.

Menyiapkan Webhook

Include a <code>webhookUrl</code> parameter in your request to receive a POST notification when processing is complete.

Payload Webhook

{
  "id": "abc123xyz",
  "status": "completed",
  "url": "https://cdn.doitong.com/outputs/abc123xyz.mp4",
  "service": "veo3",
  "createdAt": "2024-01-01T00:00:00Z",
  "completedAt": "2024-01-01T00:01:00Z",
  "metadata": {
    "duration": 5,
    "width": 1920,
    "height": 1080
  }
}

Keamanan Webhook

Semua permintaan webhook menyertakan header tanda tangan untuk verifikasi:

X-Doitong-Signature: sha256=abc123...

Batas Kecepatan

Untuk memastikan penggunaan yang adil dan stabilitas sistem, batas kecepatan berikut berlaku:

Praktik Terbaik

1. Optimalkan Prompt Anda

Tulis prompt yang jelas dan deskriptif untuk hasil terbaik:

• Be specific about visual elements, style, and mood
• Include details about lighting, camera angles, and composition
• Avoid contradictory or impossible requests

2. Tangani Pemrosesan Asinkron

Pembuatan bersifat asinkron. Terapkan polling atau webhook yang tepat:

// Polling example
async function pollStatus(jobId) {
  let status = 'processing';
  while (status === 'processing') {
    await sleep(2000); // Wait 2 seconds
    const result = await checkJobStatus(jobId);
    status = result.status;
  }
  return result;
}

3. Pemulihan Error

Terapkan logika percobaan ulang (retry) dengan exponential backoff:

async function retryWithBackoff(fn, maxRetries = 3) {
  for (let i = 0; i < maxRetries; i++) {
    try {
      return await fn();
    } catch (error) {
      if (i === maxRetries - 1) throw error;
      await sleep(Math.pow(2, i) * 1000);
    }
  }
}

4. Pantau Penggunaan Kredit

Lacak konsumsi kredit Anda untuk menghindari gangguan:

• Check credit balance before large batch operations
• Set up alerts for low credit thresholds
• Implement credit-aware request queuing

Siap untuk Memulai?

Bergabunglah dengan ribuan pengembang yang menggunakan Veo-3 API untuk membuat konten luar biasa