Panduan awal untuk alur kerja Sora 2
Hasilkan teks tanpa sensor untuk pipelines video Sora 2 Anda menggunakan API kami yang kompatibel dengan OpenAI. Panduan cepat ini mencakup autentikasi, permintaan dasar, streaming, dan pemanggilan fungsi untuk menjalankan mesin teks Anda segera.
Autentikasi dan URL dasar
API kami menggunakan autentikasi standar yang kompatibel dengan OpenAI. Anda memerlukan kunci API dari dasbor Anda dan base URL https://api.sora2apis.com/v1. Kirimkan kunci Anda di header Authorization sebagai token Bearer. Konfigurasi ini berfungsi dengan SDK apa pun yang mendukung kompatibilitas OpenAI.
Buat akun untuk mendapatkan kunci Anda. Akun baru menerima $0,50 kredit uji coba selama 7 hari, tanpa memerlukan kartu kredit. Untuk penggunaan berbayar, isi saldo dimulai dari $10. Kunci dibuat segera setelah pendaftaran dan dapat dibuat ulang kapan saja.
curl https://api.sora2apis.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
}'
Endpoint Chat Completions
Endpoint intinya adalah POST /v1/chat/completions. Endpoint ini menerima bidang model yang diatur ke uncensored, yaitu model bobot terbuka yang disesuaikan untuk menjawab tanpa penolakan konten untuk penggunaan dewasa yang sah. Ini bukan GPT, Claude, atau model vendor lain. Model ini memiliki jendela konteks 100.000 token untuk prompt dan completion.
Kirimkan input teks Anda melalui array messages. API mengembalikan output teks yang siap untuk pipeline pembuatan video Anda. Tidak ada kemampuan embedding, audio, atau pembuatan video di endpoint ini. Ini secara ketat teks masuk, teks keluar.
from openai import OpenAI
client = OpenAI(base_url="https://api.sora2apis.com/v1", api_key="YOUR_KEY")
resp = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)
Respons Streaming (SSE)
Untuk pembuatan teks waktu nyata, atur stream: true dalam permintaan Anda. API mengembalikan Server-Sent Events (SSE) yang memungkinkan Anda memproses token saat token tersebut dihasilkan. Ini berguna untuk skrip atau caption panjang di mana Anda ingin menampilkan kemajuan atau memberikan data secara bertahap.
Setiap peristiwa SSE berisi delta parsial dari respons. Akumulasi delta ini untuk merekonstruksi teks lengkap. Respons streaming mengikuti format SSE OpenAI standar, memastikan kompatibilitas dengan sebagian besar SDK modern. Ini sangat ideal untuk pembuatan konten dinamis dalam alur kerja Sora 2 Anda.
stream = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Tell the story in second person."}],
stream=True,
)
for chunk in stream:
if chunk.choices and chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="", flush=True)
Pemanggilan Fungsi dan Alat
API mendukung pemanggilan fungsi dan alat, memungkinkan Anda menentukan fungsi kustom untuk digunakan oleh model Anda. Ini sangat berharga untuk ekstraksi data terstruktur atau pengambilan keputusan otomatis dalam pipeline teks Anda. Tentukan alat Anda dalam array tools dan tentukan bagaimana model harus merespons.
Model akan mengembalikan panggilan alat jika sesuai, yang kemudian dapat Anda eksekusi dan masukkan kembali ke dalam percakapan. Ini memungkinkan alur kerja kompleks di mana mesin teks dapat berinteraksi dengan sistem eksternal atau memformat data secara tepat untuk kebutuhan pembuatan video Anda. Ini adalah fitur canggih untuk pipelines Sora 2.
Batas Laju dan Penggunaan
Anda dibatasi hingga 300 permintaan per menit per kunci. Ukuran badan permintaan maksimum adalah 8 MB. Jika Anda melebihi batas laju, Anda akan menerima error 429. Pastikan aplikasi Anda menangani percobaan ulang dengan tepat. Setiap akun mendapatkan satu kunci API, yang dapat dibuat ulang kapan saja, sehingga mencabut kunci lama.
Harga adalah $0,25 per 1M token input dan $1,00 per 1M token output. Kredit adalah saldo prabayar dan tidak pernah kedaluwarsa. Jika kredit Anda habis, Anda akan menerima kesalahan 402. Kunci yang tidak valid menghasilkan kesalahan 401. Isi saldo dimulai dari $10, dengan bonus untuk jumlah yang lebih besar.
Konfigurasi Model
ID model selalu uncensored. Ini adalah model bobot terbuka yang berjalan di server GPU kami sendiri, disesuaikan untuk konten dewasa yang sah tanpa penolakan. Ini bukan GPT, Claude, Gemini, Grok, atau DeepSeek. Model ini tidak menghasilkan audio, gambar, atau video. Ini secara khusus untuk pembuatan teks.
Anda dapat menyesuaikan parameter standar seperti temperature dan max_tokens untuk mengontrol output. Jendela konteks adalah 100.000 token. Fleksibilitas ini memungkinkan Anda menyesuaikan output teks untuk kebutuhan pembuatan video Sora 2 Anda. Model ini dirancang sebagai mesin teks yang andal untuk pipeline Anda.
Node.js
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.sora2apis.com/v1", apiKey: process.env.API_KEY });
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);Spesifikasi teknis
Semua batas dan fitur API yang sebenarnya di satu tempat — cek dulu sebelum isi saldo.
| Item | Nilai |
|---|---|
| Format | kompatibel OpenAI: SDK OpenAI apa pun bisa dipakai, cukup ganti base URL dan kunci |
| ID model | uncensored |
| Endpoint | POST /v1/chat/completions · GET /v1/models |
| Autentikasi | Authorization: Bearer YOUR_KEY |
| Base URL | https://api.sora2apis.com/v1 |
| Streaming | ya — server-sent events; potongan terakhir berisi penggunaan token |
| Jendela konteks | 100.000 token (input + output) |
| Output maksimal | hingga sisa jendela 100.000 token; max_tokens opsional (tanpa batas terpisah) |
| Parameter | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| Mode JSON | response_format: {"type": "json_object"} |
| Function calling | ya — tools, tool_choice; balasan berisi tool_calls, juga saat streaming; hasil dikirim sebagai role: tool |
| Ukuran permintaan | hingga 8 MB |
| Header respons | X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency |
| Konkurensi | 8 permintaan bersamaan per kunci |
| Batas laju | 300 permintaan per menit per kunci |
| Penagihan | saldo prabayar sesuai pemakaian nyata; error dan penolakan gratis |
| Bonus | +5% mulai $50, +10% mulai $100 |
| Masa berlaku | saldo berbayar tidak kedaluwarsa, tanpa langganan |
| Isi saldo | USDT (TRC20) atau USDC (Base), nominal bulat berapa pun dari $10 sampai $500 |
| Harga | $0,25 per 1 juta token input · $1,00 per 1 juta token output |
| Uji coba gratis | $0,50 selama 7 hari, tanpa kartu · Kunci uji coba: 2 permintaan paralel, 60 per menit; batas penuh (8 dan 300) setelah isi saldo pertama |
| Kunci | satu kunci aktif per akun; kunci baru menggantikan yang lama |
| Konten | konten dewasa diizinkan; konten seksual yang melibatkan anak di bawah umur ditolak |
| Masuk | Google atau email dan kata sandi |
Kode error
Error dikirim sebagai JSON dengan type tetap; permintaan gagal atau ditolak tidak ditagih.
| Kode | Tipe | Arti |
|---|---|---|
400 | bad_request | JSON tidak valid, pesan kosong, parameter salah, atau konteks terlalu panjang |
401 | missing_key · invalid_key · key_revoked | kunci tidak ada, salah, atau sudah diganti |
402 | no_credit | saldo habis — isi ulang dan lanjut seketika |
403 | content_blocked | konten seksual dengan anak di bawah umur — ditolak, tidak ditagih |
404 | not_found | endpoint tidak dikenal |
413 | request_too_large | body lebih dari 8 MB |
429 | rate_limited · concurrency | lebih dari 300/menit atau 8 paralel — tunggu lalu coba lagi |
503 | upstream_busy | model sibuk — coba lagi beberapa detik lagi |
Tanya jawab
Berapa ukuran jendela konteks?
Jendela konteks adalah 100.000 token, yang mencakup prompt dan completion. Ini memungkinkan pembuatan konten panjang yang cocok untuk skrip dan caption terperinci.
Bagaimana cara menangani batas laju?
Anda dibatasi hingga 300 permintaan per menit per kunci. Jika Anda melebihi batas ini, Anda akan menerima error 429. Terapkan backoff eksponensial dalam aplikasi Anda untuk menangani percobaan ulang dengan lancar.
Apakah konten benar-benar tanpa sensor?
Model tidak menolak topik dewasa yang sah, fiksi, penelitian keamanan, atau kontroversial. Namun, konten seksual yang melibatkan anak di bawah umur selalu diblokir. Model ini dirancang untuk kebebasan kreatif dalam batas hukum.
Kunci Anda hanya selangkah lagi dari satu formulir
Buat akun, salin kunci, ubah base URL. Itu saja seluruh pengaturannya.
Dapatkan kunci API