Autentikasi
Token Bearer di header Authorization. Buat kunci di Pengaturan dan cabut kunci mana pun kapan saja.
Authorization: Bearer oc_live_...Gambar, video, audio, dan 3D di balik satu API, dibayar dari saldo yang sama dengan studio. Buat kunci di Pengaturan; CLI segera hadir.
segeraCLI Opencran segera hadir. Halaman ini memperlihatkan cara kerjanya; sampai saat itu, gunakan API.
npm i -g @opencran/cliGanti ID model untuk beralih antara gambar, video, dan suara. Kolomnya mengikuti model.
1import { writeFile } from "node:fs/promises";2 3const API = "https://opencran.com/api/v1/api/catalog";4const auth = { Authorization: `Bearer ${process.env.OPENCRAN_API_KEY}` };5 6// 1. Generate an image7const res = await fetch(`${API}/generations`, {8 method: "POST",9 headers: { ...auth, "Content-Type": "application/json", "Idempotency-Key": crypto.randomUUID() },10 body: JSON.stringify({11 modelId: "luma/uni-v1/text-to-image",12 inputs: { prompt: "Neon city street after rain, cinematic night", size: "16:9" },13 }),14});15let { generation } = await res.json();16 17// 2. Wait for the result18while (generation.status === "queued" || generation.status === "generating") {19 await new Promise((r) => setTimeout(r, 3000));20 ({ generation } = await (await fetch(`${API}/generations/${generation.id}`, { headers: auth })).json());21}22 23// 3. Save the file24const file = await fetch(`${API}/generations/${generation.id}/content`, { headers: auth });25await writeFile("result.jpeg", Buffer.from(await file.arrayBuffer()));
export OPENCRAN_API_KEY="oc_live_..."opencran run luma/uni-v1/text-to-image -p "violet neon fox" -o ./out/Jalankan model apa pun dari shell, job CI, atau agen coding. Setiap render diberi harga sebelum dimulai dan dibayar dari saldo yang sama.
opencran loginTempel kunci API Anda sekali; kunci diperiksa lalu disimpanopencran whoamiNama kunci dan saldo Andaopencran models --type videoSemua model video beserta harga awalnyaopencran run <model> -hKolom sebuah model, diambil langsung: tipe, default, nilai yang diizinkanopencran run <model> -p "<prompt>" -o ./out/Render dan simpan hasilnya di folderopencran run <model> -p "..." --dry-runHarga pastinya, tanpa mengeluarkan apa punopencran run <model> -p "..." --max-price 0.50Menolak berjalan jika harganya lebih tinggiopencran run <model> -p "..." --json -o ./out/Satu hasil JSON, siap untuk langkah berikutnyaopencran skill installAjari agen coding Anda memakai CLIToken Bearer di header Authorization. Buat kunci di Pengaturan dan cabut kunci mana pun kapan saja.
Authorization: Bearer oc_live_...Memulai render langsung menjawab dengan status queued. Polling render sampai berhasil, gagal, atau dikembalikan dananya.
{ "status": "queued" }Minta harga pasti untuk input Anda tanpa memulai apa pun. Semua jumlah dalam sen euro.
POST /api/v1/api/catalog/quoteKirim header Idempotency-Key dan permintaan yang diulang tidak akan pernah ditagih dua kali.
Idempotency-Key: render-042Setiap kunci punya batas per menit dan batas harian opsional. Melewati batas, API menjawab 429.
429 Too Many RequestsError JSON dengan kode dan pesan. Render yang gagal otomatis dikembalikan ke saldo Anda.
{ "status": "refunded" }/api/catalog/meKunci dan saldo Anda/api/catalog/modelsSemua model/api/catalog/models/detail?id=MODEL_IDSatu model dan kolomnya/api/catalog/quoteHarga untuk input tertentu/api/catalog/generationsMulai render/api/catalog/generationsRender terbaru Anda/api/catalog/generations/IDStatus satu render/api/catalog/generations/ID/contentFile hasil/api/catalog/generations/IDHapus renderIsi saldo €3 dan rilis hari ini
Buat kunci API di Pengaturan dan panggil model apa pun. CLI segera hadir. Render yang gagal dikembalikan.