Build once. Run every model.

GetRun API memberi Anda akses terstandar ke model image, video, audio, dan lainnya melalui satu endpoint yang konsisten. Bayar hanya untuk hasil yang sukses.

1. Quickstart

Buat task pertama Anda dalam hitungan detik. Generation berjalan asynchronous: buat task, lalu poll statusnya sampai selesai. Contoh dengan GetRun Assemble:

curl -X POST https://getrun.id/v1/tasks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Idempotency-Key: my-task-001" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "getrun-edit/assemble",
    "input": {
      "clips": [
        "https://storage.getcore.id/outputs/task_a/0.mp4"
      ],
      "seconds": 3,
      "timeline": "{\"segments\":[{\"clip\":0,\"start\":0,\"end\":3,\"caption\":\"Stop scrolling\"}]}",
      "resolution": "720p",
      "aspect_ratio": "9:16"
    }
  }'

const res = await fetch('https://getrun.id/v1/tasks', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer YOUR_API_KEY',
    'Idempotency-Key': 'my-task-001',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "model": "getrun-edit/assemble",
    "input": {
      "clips": [
        "https://storage.getcore.id/outputs/task_a/0.mp4"
      ],
      "seconds": 3,
      "timeline": "{\"segments\":[{\"clip\":0,\"start\":0,\"end\":3,\"caption\":\"Stop scrolling\"}]}",
      "resolution": "720p",
      "aspect_ratio": "9:16"
    }
  }),
});
const task = await res.json();

import requests

res = requests.post(
    "https://getrun.id/v1/tasks",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Idempotency-Key": "my-task-001",
    },
    json={
      "model": "getrun-edit/assemble",
      "input": {
        "clips": [
          "https://storage.getcore.id/outputs/task_a/0.mp4"
        ],
        "seconds": 3,
        "timeline": "{\"segments\":[{\"clip\":0,\"start\":0,\"end\":3,\"caption\":\"Stop scrolling\"}]}",
        "resolution": "720p",
        "aspect_ratio": "9:16"
      }
    },
)
task = res.json()

2. Authentication

Setiap request harus menyertakan API key Anda di header Authorization. Key penuh hanya ditampilkan sekali saat dibuat.

3. Task lifecycle

Membuat task, cek status, ambil hasil

queued → processing → succeeded
   │          │
   ├──────────┴──→ failed      (tidak ditagih, reservasi dikembalikan)
   └─────────────→ cancelled   (hanya saat masih queued)

Poll GET /v1/tasks/{task_id} tiap 2–5 detik. Task yang masih queued bisa dibatalkan via POST /v1/tasks/{task_id}/cancel.

4. Harga & billing

• Semua harga integer Rupiah (IDR), terlihat sebelum task dijalankan; estimasi pasti via POST /v1/quotes.
• Saat task dibuat, saldo direservasi sebesar estimasi; setelah sukses biaya final ditagih dan sisa reservasi dikembalikan.
• Task gagal tidak dikenakan biaya — price.final menjadi 0.
• URL output berlaku 7 hari — salin file ke penyimpananmu sendiri.
• Semua endpoint mutasi mendukung Idempotency-Key (wajib di POST /v1/tasks, disimpan 24 jam) — retry aman, tidak dobel tagih.

Models

Setiap model punya halaman referensinya sendiri. Daftar live juga tersedia via GET https://getrun.id/v1/models.

5. Endpoints

File input (image-to-image, start frame, video referensi)

Parameter model bertipe file (mis. image_urls, first_frame_url, reference_video_urls) diisi URL. Upload dulu filenya:

curl -X POST https://getrun.id/v1/uploads \
  -H "Authorization: Bearer run_live_xxx" \
  -F "file=@foto.jpg"

# 201 -> { "url": "https://storage.getcore.id/inputs/...", "type": "image",
#          "size": 123456, "duration_seconds": null }

Lalu pakai url tersebut di input task. Gambar/audio maks 25 MB, video maks 50 MB; file disimpan 7 hari. Untuk gambar boleh juga URL publik milikmu sendiri, tapi video referensi wajib dari /v1/uploads — durasinya diukur saat upload dan menjadi dasar perhitungan harga.

6. Rate limits

Setiap akun punya batas request yang wajar untuk menjaga stabilitas platform. Jika terlampaui, API membalas 429 dengan kode rate_limited — tunggu sejenak lalu retry (request dengan Idempotency-Key aman diulang). Butuh limit lebih tinggi? Hubungi support@getcore.id.

7. Error handling

Semua error memakai satu envelope. Simpan request_id saat menghubungi support.

{
  "error": {
    "code": "insufficient_balance",
    "message": "Balance is lower than the maximum task cost.",
    "request_id": "req_...",
    "details": {}
  }
}

8. Connector MCP

Selain REST API di atas, GetRun juga berjalan sebagai remote MCP server. Pasang sekali di Claude (atau klien MCP lain), lalu jalankan model image, video, audio, dan chat memakai saldo GetRun langsung dari dalam percakapan — tanpa API key, karena aksesnya diberikan lewat OAuth dan bisa dicabut kapan saja.

Pasang di Claude

1. Buka Settings → Connectors → Add custom connector.
2. Tempel URL https://getrun.id/mcp, lalu Connect.
3. Login ke akun GetRun, pilih izin yang diberikan, lalu setujui.

Panduan versi panjangnya ada di https://getrun.id/connect. Daftar koneksi aktif dan tombol cabutnya ada di Settings — mencabut koneksi langsung mematikan aksesnya.

Izin

Izin dipilih user saat menghubungkan, dan ditegakkan per tool. Tool di luar izin yang diberikan menolak jalan dengan pesan yang menjelaskan izin apa yang kurang.

Tools

Semua tool memanggil endpoint /v1 yang sama dengan REST API — harga, reservasi saldo, validasi parameter, dan rate limit-nya identik, dan hasilnya ikut tercatat di Usage.

OAuth 2.1

Transport-nya Streamable HTTP (satu POST = satu JSON-RPC request/response); versi protokol MCP yang didukung: 2025-06-18 2025-03-26 2024-11-05. Klien mendaftar sendiri lewat Dynamic Client Registration, jadi tidak ada client secret yang perlu dibagikan — PKCE S256 wajib, dan refresh token dirotasi setiap kali dipakai.

Request tanpa token yang sah dibalas 401 dengan header WWW-Authenticate yang menunjuk ke metadata di atas — dari situ klien MCP mengurus sisanya sendiri.

Untuk LLM & coding agent

• https://getrun.id/llms.txt — seluruh API dalam markdown ringkas, selalu sinkron dengan katalog.
• https://getrun.id/openapi-v1.yaml — spesifikasi OpenAPI 3.1.

Support

Email support@getcore.id — sertakan request_id atau task_id.