Operasional

Daftar periksa produksi

Menyiapkan integrasi generasi yang andal: biaya, tugas, webhook, dan pemulihan kesalahan.

Baca 1 menit2 bagian

Kesiapan produksi dimulai sebelum panggilan API: validasi masukan, perkirakan harga, simpan taskId, dan proses hasil secara asinkron.

Prinsip praktis

Pilih model berdasarkan prioritas — kecepatan, kesetiaan, resolusi, atau kontrol — lalu simpan parameter dan versi setiap hasil. the model selected for the task — Production checklist.

Ubah satu hal dalam setiap percobaan. Hasil yang baik menjadi referensi dan titik awal paling andal untuk iterasi berikutnya.

Perlakukan finished dan failed sebagai status akhir. Gunakan polling atau webhook, simpan kesalahan mentah di server, dan tampilkan pesan aman kepada pengguna.

Prompt dan contoh API

json

{
  "model": "veo3.1-fast",
  "input": { "prompt": "…", "aspectRatio": "16:9" },
  "webhook": "https://example.com/hooks/api-stock/8f2c1e9a-b40d-4c77-9a1e-secret"
}

json

{
  "code": 402,
  "error": {
    "message": "Insufficient balance. Please top up your account",
    "type": "PaymentRequired",
    "code": "insufficient_balance"
  }
}

  curl https://api.api-stock.com/api/v1/user/me \
    -H "Authorization: Bearer sk-your-key"

json

  {
    "code": 200,
    "data": {
      "id": "019c1f70-2b44-70d3-9c22-6b7ad0f41e18",
      "balance": 48250,
      "createdAt": "2026-01-14T09:03:11.000Z"
    }
  }

curl https://api.api-stock.com/api/v1/catalog

curl https://api.api-stock.com/api/v1/catalog/veo3.1-fast

Jalankan dengan kunci Anda sendiri

Semua model dalam panduan ini tersedia di katalog API Stock — satu kunci API, satu saldo prabayar, tanpa pendaftaran terpisah di tiap penyedia.

Lihat katalog Referensi API

Lanjut membaca

Prinsip praktis

Pilih model berdasarkan prioritas — kecepatan, kesetiaan, resolusi, atau kontrol — lalu simpan parameter dan versi setiap hasil. the model selected for the task — Production checklist.

Ubah satu hal dalam setiap percobaan. Hasil yang baik menjadi referensi dan titik awal paling andal untuk iterasi berikutnya.

Perlakukan finished dan failed sebagai status akhir. Gunakan polling atau webhook, simpan kesalahan mentah di server, dan tampilkan pesan aman kepada pengguna.

Prompt dan contoh API

json

{
  "model": "veo3.1-fast",
  "input": { "prompt": "…", "aspectRatio": "16:9" },
  "webhook": "https://example.com/hooks/api-stock/8f2c1e9a-b40d-4c77-9a1e-secret"
}

json

{
  "code": 402,
  "error": {
    "message": "Insufficient balance. Please top up your account",
    "type": "PaymentRequired",
    "code": "insufficient_balance"
  }
}

  curl https://api.api-stock.com/api/v1/user/me \
    -H "Authorization: Bearer sk-your-key"

json

  {
    "code": 200,
    "data": {
      "id": "019c1f70-2b44-70d3-9c22-6b7ad0f41e18",
      "balance": 48250,
      "createdAt": "2026-01-14T09:03:11.000Z"
    }
  }

curl https://api.api-stock.com/api/v1/catalog

curl https://api.api-stock.com/api/v1/catalog/veo3.1-fast