Tasks

Buat generation task

Memvalidasi input terhadap parameter schema model, menyimpan price snapshot, mereservasi saldo maksimum, lalu mengantrekan task.

Task gagal tidak ditagih; reservasi dilepas otomatis.

post/tasks

Request

  • Base URL: https://getrun.id/v1
  • URL: https://getrun.id/v1/tasks
  • Auth: HTTP bearer

Headers

Idempotency-Keystring required

Key unik per operasi (maks 255 karakter, disimpan 24 jam). Request ulang dengan key sama mengembalikan response asli tanpa efek ganda.

Request body

modelstring required
inputobject required

Parameter model sesuai parameters_schema pada detail model.

quote_idstring

Opsional. Bila diberikan dan masih berlaku, harga quote dipakai sebagai snapshot.

webhook_urlstring uri

Opsional; menimpa webhook default project untuk task ini.

metadataobject

Key-value bebas milik client, dikembalikan apa adanya.

Example request

{
  "model": "google/veo-3.1",
  "input": {
    "prompt": "A cinematic sunrise above Jakarta",
    "duration_seconds": 8,
    "aspect_ratio": "16:9"
  }
}

Response

Task diterima dan berstatus queued.

idstring required
status'queued' | 'processing' | 'succeeded' | 'failed' | 'cancelled' required
modelstring required
inputobject
webhook_urlstring uri
metadataobject
created_atstring date-time required
started_atstring date-time
completed_atstring date-time

Example response

{
  "id": "task_01J8Z3N0V9X2M4K6P8Q0R2S4T6",
  "model": "google/veo-3.1",
  "price": {
    "estimated": 22500,
    "reserved": 22500
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.