ID ▾
Dapatkan kunci API

API gaya OpenAI dengan cURL dan Token Bearer

Untuk memanggil API gaya OpenAI dari baris perintah, Anda mengirim HTTP POST dengan header Authorization yang membawa token Anda. Halaman ini memberikan perintah cURL yang berfungsi untuk setiap fitur API ini, dan pemeriksaan yang harus dilakukan jika gagal.

Diperbarui

Jendela terminal mengirimkan kunci emas dan paket data sepanjang pita cahaya ke server

Poin utama

  • Token ditempatkan di header Authorization: Bearer YOUR_KEY, dan ID model adalah uncensored.
  • Dua endpoint ada: GET /v1/models dan POST /v1/chat/completions.
  • Tambahkan -N dan stream true untuk melihat token tiba melalui server-sent events.
  • Baca header X-Balance-USD dan header batas laju dengan curl -i; kode 429 berarti tunggu dan coba lagi.

Permintaan minimal

Berikut cara terpendek untuk melakukan open ai api curl dengan token terhadap layanan ini. Masukkan kunci ke variabel lingkungan agar tidak masuk ke riwayat shell Anda, lalu kirim pesan chat:

export UF_KEY="paste-your-key-here"

curl https://api.unfilteredaimodels.com/v1/chat/completions \
  -H "Authorization: Bearer $UF_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [
      {"role": "user", "content": "Explain what a bearer token is in two sentences."}
    ]
  }'

Responsnya adalah JSON dalam bentuk penyelesaian chat OpenAI. Jawaban berada di choices[0].message.content, dan objek usage melaporkan token prompt dan penyelesaian. Setiap bagian perintah memiliki tugas:

  • Authorization: Bearer ... membawa token. "Bearer" adalah nama skema; siapa pun yang memegang token diperlakukan sebagai pemiliknya, itulah sebabnya Anda menyimpannya di luar repositori publik.
  • Content-Type: application/json memberi tahu server cara membaca body. Tanpanya, permintaan sering gagal dengan kesalahan parsing body.
  • model harus uncensored, satu-satunya model yang dilayani API ini.
  • messages adalah daftar objek dengan role (system, user, assistant atau tool) dan content.

Untuk mendapatkan kunci, daftar dengan Google atau email dan kata sandi, lalu buka halaman kunci API. Pengguna baru dapat mengklaim kredit uji coba senilai $0,50 dengan satu klik di sana: tanpa kartu, berlaku selama 7 hari, satu per orang.

Periksa kunci dengan GET /v1/models

Sebelum men-debug permintaan panjang, konfirmasi bahwa token berfungsi dengan panggilan termurah yang tersedia. Daftar model tidak memakan biaya dan menunjukkan apakah URL, header, dan kunci semuanya benar.

curl -s https://api.unfilteredaimodels.com/v1/models \
  -H "Authorization: Bearer $UF_KEY"

Jawaban yang baik adalah daftar JSON yang menyertakan uncensored. Jika Anda telah menginstal jq, alirkan output untuk mengekstrak hanya ID:

curl -s https://api.unfilteredaimodels.com/v1/models \
  -H "Authorization: Bearer $UF_KEY" | jq -r '.data[].id'

Jika tidak ada yang berguna yang dikembalikan, kerjakan daftar di bawah ini secara berurutan, karena penyebabnya disusun berdasarkan seberapa sering kejadian tersebut terjadi:

  1. Variabelnya kosong. Jalankan echo "${UF_KEY:0:6}" untuk melihat karakter pertama tanpa mencetak seluruh kunci.
  2. Header salah eja, atau "Bearer" hilang sebelum kunci.
  3. Tanda kutip melengkung dari dokumen atau klien chat menggantikan tanda kutip lurus dalam perintah.
  4. URL dasar salah. Itu https://api.unfilteredaimodels.com/v1, dengan api. di depan dan /v1 di akhir.
  5. Kunci disalin dengan spasi atau baris baru di akhir.

Baca header respons

Tambahkan -i untuk menyertakan header dalam output, atau -D - untuk mencetaknya sambil menjaga body tetap bersih:

curl -s -D - -o /dev/null \
  https://api.unfilteredaimodels.com/v1/chat/completions \
  -H "Authorization: Bearer $UF_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","max_tokens":5,"messages":[{"role":"user","content":"ping"}]}'

Empat header respons penting untuk diketahui:

HeaderArti
X-Request-IdPengidentifikasi untuk permintaan ini. Kutip jika Anda menghubungi dukungan.
X-Balance-USDSaldo prabayar Anda yang tersisa.
X-RateLimit-Limit-RequestsPermintaan per menit yang diizinkan untuk kunci Anda.
X-RateLimit-Limit-ConcurrencyPermintaan simultan yang diizinkan untuk kunci Anda.

Batasnya adalah 300 permintaan per menit dan 8 permintaan paralel untuk kunci penuh, serta 60 per menit dan 2 paralel untuk kunci uji coba. Permintaan di atas menetapkan max_tokens menjadi 5 hanya untuk menjaga agar pengujian tetap kecil. Dalam penggunaan normal, max_tokens bersifat opsional, dan penyelesaian dapat menggunakan sisa dari jendela 100.000 token setelah prompt Anda.

Streaming dari baris perintah

Atur "stream": true dan tambahkan -N agar curl tidak melakukan buffering output. Anda akan melihat baris yang dimulai dengan data:, masing-masing membawa delta JSON kecil, dan data: [DONE] terakhir. Chunk sebelum data [DONE] tersebut mencakup penggunaan token.

curl -N https://api.unfilteredaimodels.com/v1/chat/completions \
  -H "Authorization: Bearer $UF_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "stream": true,
    "messages": [{"role": "user", "content": "Write a four-line poem about a cron job."}]
  }'

Untuk mencetak hanya teks, filter stream dengan pipeline pendek:

curl -sN https://api.unfilteredaimodels.com/v1/chat/completions \
  -H "Authorization: Bearer $UF_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","stream":true,"messages":[{"role":"user","content":"Count to five."}]}' \
  | sed -u 's/^data: //' | grep -v '^\[DONE\]' | grep -v '^$' \
  | jq -rj '.choices[0].delta.content // empty'
echo

Permintaan streaming memegang slot konkurensinya hingga streaming berakhir. Jika Anda memulai banyak streaming secara paralel dari skrip dan lupa membiarkannya selesai, Anda akan mencapai batas konkurensi meskipun laju permintaan rendah.

Mode JSON dan panggilan alat

Mode JSON membuat model mengembalikan satu objek JSON yang valid. Nyatakan bentuk yang Anda inginkan dalam prompt, atau kuncinya akan menjadi apa pun yang dipilih model.

curl -s https://api.unfilteredaimodels.com/v1/chat/completions \
  -H "Authorization: Bearer $UF_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "response_format": {"type": "json_object"},
    "messages": [
      {"role": "user", "content": "Return JSON with keys city and country for the capital of Portugal."}
    ]
  }' | jq -r '.choices[0].message.content'

Pemanggilan alat menggunakan bidang tools dan tool_choice standar. Model menjawab dengan array tool_calls alih-alih teks; Anda menjalankan fungsi sendiri dan mengirim hasilnya kembali sebagai pesan dengan role: "tool" dan tool_call_id yang sesuai.

curl -s https://api.unfilteredaimodels.com/v1/chat/completions \
  -H "Authorization: Bearer $UF_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "tool_choice": "auto",
    "tools": [{
      "type": "function",
      "function": {
        "name": "get_weather",
        "description": "Get current weather for a city",
        "parameters": {
          "type": "object",
          "properties": {"city": {"type": "string"}},
          "required": ["city"]
        }
      }
    }],
    "messages": [{"role": "user", "content": "What is the weather in Lisbon?"}]
  }'

Di balasan, cari choices[0].message.tool_calls[0].function.arguments. Itu adalah string JSON yang Anda parse, panggil fungsi cuaca Anda sendiri dengannya, dan kembalikan dalam permintaan berikutnya. Parameter seperti temperature, top_p, stop, seed dan penalti diteruskan. dokumentasi mencantumkan semua bidang yang didukung.

Jaga token tetap aman dan perintah tetap rapi

Token bearer adalah kata sandi dengan nama berbeda. Siapa pun yang memilikinya dapat menghabiskan saldo Anda, jadi perlakukan dengan hati-hati. Jangan pernah menempelkan kunci asli ke masalah publik, tangkapan layar, atau log terminal bersama. Jika Anda mencurigai kunci bocor, ganti dari halaman kunci dan perbarui skrip Anda.

Riwayat shell adalah kebocoran paling umum di mesin pribadi. Mengetik kunci langsung ke dalam perintah menyimpannya di file riwayat. Mengatur sekali dengan export masih menyimpan baris itu. Dua kebiasaan yang lebih bersih membantu. Baca kunci dari file yang hanya dapat Anda buka, atau awali perintah dengan spasi jika shell Anda diatur untuk mengabaikan baris yang diawali spasi. File kecil berfungsi dengan baik:

mkdir -p ~/.config/uf
printf '%s' 'paste-your-key-here' > ~/.config/uf/key
chmod 600 ~/.config/uf/key

export UF_KEY="$(cat ~/.config/uf/key)"

Body JSON panjang sulit dibaca di dalam tanda kutip tunggal, dan pengutipan rusak segera setelah prompt itu sendiri mengandung apostrof. Masukkan body ke dalam file dan biarkan curl membacanya dengan -d @file:

cat > request.json <<'JSON'
{
  "model": "uncensored",
  "temperature": 0.3,
  "messages": [
    {"role": "system", "content": "You answer in plain language."},
    {"role": "user", "content": "What's the difference between a 401 and a 403 status code?"}
  ]
}
JSON

curl -s https://api.unfilteredaimodels.com/v1/chat/completions \
  -H "Authorization: Bearer $UF_KEY" \
  -H "Content-Type: application/json" \
  -d @request.json | jq -r '.choices[0].message.content'

Pendekatan yang sama menjaga prompt besar tetap dapat dikelola di bawah batas body 8 MB, dan file dapat dicatat versinya di git sementara kunci tetap berada di luar repositori. Di PowerShell Windows, tanda kutip tunggal di sekitar JSON berperilaku berbeda dan kelanjutan baris backslash tidak ada; bentuk -d @request.json menghindari kedua masalah tersebut, dan Anda dapat menggunakan backtick di akhir baris untuk melanjutkan perintah.

Saat Anda selesai menguji, beralihlah ke SDK. Perpustakaan Python dan Node OpenAI menerima URL dasar dan kunci yang sama, menangani percobaan ulang dan streaming untuk Anda, dan membaca format respons yang sama yang telah Anda parse secara manual di sini. Perintah cURL tetap menjadi cara tercepat untuk memeriksa apakah kegagalan berasal dari kode Anda atau dari permintaan itu sendiri, jadi simpan yang diketahui benar di catatan Anda. Saat melaporkan masalah ke dukungan, sertakan X-Request-Id dari panggilan yang gagal dan kode status persis; pasangan itu memungkinkan seseorang menemukan permintaan tanpa meminta Anda mengulangi pengujian, dan itu menghemat putaran bolak-balik.

Kesalahan, percobaan ulang, dan biaya per panggilan

Saat Anda melebihi batas, API menjawab dengan HTTP 429. Kode kesalahan memberi tahu Anda batas mana: rate_limited berarti terlalu banyak permintaan per menit, concurrency berarti terlalu banyak sekaligus. Beban sementara juga mengembalikan 429 dan menambahkan Retry-After: 5. Curl dapat mencoba lagi secara otomatis untuk kesalahan sementara:

curl --retry 3 --retry-delay 5 --retry-all-errors \
  https://api.unfilteredaimodels.com/v1/chat/completions \
  -H "Authorization: Bearer $UF_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"Hello"}]}'

Jaga juga body di bawah 8 MB, karena hal ini penting jika Anda memposting file yang dienkoding ke dalam prompt.

Permintaan yang gagal atau ditolak tidak dikenakan biaya. Permintaan yang berhasil mengikuti rumus sederhana: $0,15 per 1 juta token input dan $0,50 per 1 juta token output. Panggilan pengujian dengan 40 token input dan 120 token output biaya 40 / 1.000.000 x $0,15 = $0,000006 ditambah 120 / 1.000.000 x $0,50 = $0,00006, sehingga totalnya $0,000066. Seribu dari mereka mencapai $0,066.

Kredit adalah saldo prabayar dan tidak pernah kedaluwarsa. Pengisian ulang dimulai dari $20 hingga $500 dalam jumlah utuh, dengan bonus 5% dari $50, 10% dari $100 dan 15% dari $200, dengan kripto (USDT di TRC20, USDC di Base). halaman harga menampilkan detailnya. Jika respons terlihat salah, halaman mitos dan fakta menjelaskan apa yang dilakukan dan tidak dilakukan oleh model.

Tanya jawab

Kunci Anda hanya selangkah lagi dari satu formulir

Buat akun, salin kunci, ubah URL dasar. Itu saja seluruh proses pengaturannya.

Di mana token ditempatkan dalam perintah cURL?
    Dalam header: -H "Authorization: Bearer YOUR_KEY". Body permintaan juga memerlukan header Content-Type: application/json.
Nama model apa yang harus saya gunakan?
    Gunakan uncensored. Anda dapat memverifikasinya dengan GET /v1/models.
Mengapa saya mendapatkan 429?
    Anda melewati batas. Kode rate_limited berarti terlalu banyak permintaan per menit, concurrency berarti terlalu banyak sekaligus. Tunggu beberapa detik, atau kurangi jumlah panggilan paralel.
Bagaimana cara melihat sisa saldo Anda?
    Setiap respons menyertakan header X-Balance-USD. Cetak header dengan curl -i atau curl -D -.
Apakah ini API OpenAI resmi?
    Tidak. Ini adalah layanan independen yang kompatibel dengan OpenAI dan menjalankan satu model bobot terbuka, sehingga SDK dan perintah cURL yang dibuat untuk format OpenAI berfungsi setelah mengubah URL dasar dan kunci API.