Panduan Pengintegrasian untuk Pembangun

URL Asas dan Pengesahan

Mula-mula, arahkan klien anda ke URL asas kami dan sediakan kunci API anda dalam header authorization. Ini berfungsi dengan mana-mana SDK serasi OpenAI kerana kami mengikuti protokol piawai dengan tepat. Jana kunci anda serta-merta melalui Google atau e-mel di halaman Dapatkan Kunci API; tiada nombor telefon diperlukan. Pastikan kunci anda selamat dan gunakan satu kunci aktif per akaun, kerana menjana kunci baharu akan menggantikan yang lama.

Pengesahan adalah mudah. Hantar kunci anda dalam Authorization header untuk setiap permintaan. Sistem kami mengesahkan kunci sebelum memproses token, memastikan hanya akaun yang dibenarkan menggunakan kredit. Ralat seperti kunci yang hilang mengembalikan status 401 serta-merta.

Permintaan Pertama

Hantar permintaan penyelesaian chat standard untuk menguji sambungan dan kualiti respons. Panggilan mudah ini mengesahkan kunci anda dan mengesahkan akaun anda dengan betul. ID model ialah uncensored, yang mengendalikan input dan output teks tanpa penolakan kandungan untuk penggunaan dewasa yang sah. Gantikan pemegang tempat dengan kunci sebenar dan arahan sistem anda.

Copycurl https://api.deepseekapicost.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "calculate total monthly cost for 1 million tokens"}]
  }'

Arahan curl ini menunjukkan struktur minimum yang diperlukan. Anda boleh menyesuaikan messages array to include context or instructions. The response returns the generated text in the content bidang. Periksa statistik penggunaan dalam header respons untuk memantau penggunaan token anda.

SDK Python

Gunakan perpustakaan Python rasmi OpenAI untuk mengintegrasikan API kami ke dalam skrip atau aplikasi anda. Tetapkan base_url dan api_key atribut sebelum membuat panggilan. Pendekatan ini memastikan keserasian dengan pangkalan kod sedia ada yang sudah menggunakan model OpenAI. Anda boleh bertukar antara penyedia dengan mengubah hanya dua baris konfigurasi.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.deepseekapicost.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)

Sampel Python di atas menunjukkan cara memulakan klien dan menghantar permintaan. Perpustakaan mengendalikan pengaturcaraan semula JSON dan penguraian respons secara automatik. Anda boleh mengakses objek respons untuk mengekstrak kandungan, statistik penggunaan, dan sebab penyelesaian. Kaedah ini sesuai untuk perkhidmatan backend atau landasan pemprosesan data.

SDK Node

Integrasi API kami ke dalam aplikasi Node.js menggunakan openai pakej npm. Konfigurasikan klien dengan URL asas kami dan kunci API anda sama seperti yang anda lakukan untuk OpenAI. Ini membolehkan anda menggunakan struktur kod yang sama untuk pengujian dan pengeluaran. SDK menyokong operasi asinkron untuk permintaan tanpa blokir.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.deepseekapicost.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);

Contoh Node.js ini menunjukkan penghantaran permintaan penyelesaian sembang. The await kata kunci memastikan respons diterima sepenuhnya sebelum meneruskan. Anda boleh mengendalikan ralat menggunakan blok cuba-tangkap untuk mengurus isu rangkaian atau had API dengan baik. Objek respons mengandungi teks yang dijana dan butiran penggunaan token.

Aliran

Dayakan penstriman untuk menerima respons token demi token bagi meningkatkan pengalaman pengguna dalam antara muka sembang. Tetapkan stream parameter kepada true dalam permintaan anda. API mengembalikan pecahan teks sejajar dengan penjanaan, membolehkan anda memaparkan output secara masa nyata. Ini mengurangkan latensi yang dirasakan untuk pengguna akhir dengan ketara.

Copystream = 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)

Kod penstriman di atas memproses setiap pecahan apabila ia tiba. Anda boleh menambah kandungan ke elemen UI serta-merta. Pecahan terakhir mengandungi statistik penggunaan token keseluruhan. Ciri ini disokong oleh semua klien serasi OpenAI yang mengendalikan respons SSE dengan betul.

Had, Ralat, dan Tetingkap Konteks

API kami mengenakan had yang ketat untuk memastikan penggunaan yang adil dan kestabilan sistem. Anda dibenarkan membuat 300 permintaan setiap minit dan 8 permintaan kekoncurrentan per kunci. Setiap badan permintaan tidak boleh melebihi 8 MB. Jika anda melebihi had ini, API memulangkan kod status 429. Tunggu beberapa saat dan cuba semula permintaan anda. Ralat seperti kunci tidak sah memulangkan 401, dan kredit tidak mencukupi memulangkan 402.

Tingkap konteks menyokong sehingga 100,000 token untuk input dan output gabungan. Output maksimum setiap permintaan ialah 16,000 token, atau 2,048 jika anda tidak menentukan max_tokens. Tetingkap besar ini membolehkan anda memproses dokumen panjang atau mengekalkan sejarah perbualan yang luas tanpa pemotongan. Ralat dan penolakan tidak menggunakan kredit, jadi anda hanya membayar untuk penggunaan sebenar.