Ghid de Începere Rapidă API Kimi

Precondiții: instalarea SDK-ului

Instalează SDK-ul oficial pentru limbajul tău preferat pentru a gestiona automat autentificarea și serializarea. API-ul nostru se conformează standardului OpenAI, astfel încât orice librărie client compatibilă funcționează cu modificări minime de configurare.

Pentru Python, instalează biblioteca prin pip. Pentru Node.js, folosește npm sau yarn. Aceste instrumente gestionează clientul HTTP și analiza JSON pentru tine.

Autentificare: Setarea cheii API kimi

Obțineți-vă cheia din panoul de control și transmiteți-o ca Authorization header. Folosește URL-ul de bază https://api.apikimi.cc/v1 pentru toate solicitările.

Stocați cheia în siguranță în variabilele dvs. de mediu sau fișierele de configurare. Formatul header-ului este Bearer YOUR_API_KEY.

Trimiterea primei cereri

Trimite o cerere POST la /v1/chat/completions cu ID-ul modelului uncensored. Răspunsul returnează textul generat direct.

Asigură-te că setezi model câmp corect. API-ul returnează ieșirea brută fără refuzuri de conținut pentru subiecte legale.

Răspunsuri în streaming

Activați streaming-ul setând stream: true în corpul solicitării. Acesta returnează bucăți sub formă de Evenimente trimise de server (SSE).

Analizați fluxul SSE pentru a afișa tokenii în timp real. Ultimul fragment include statisticile de utilizare a tokenilor pentru facturare.

Configurare apelare funcții

Definește instrumente în tools array în cererea ta. Modelul returnează apeluri de unelte în loc de text direct când este cazul.

Gestionați apelurile de instrumente în logica aplicației dvs. și trimiteți rezultatele înapoi la API pentru procesare suplimentară. Suport pentru tool_choice permite aplicarea strictă.

Gestionarea erorilor și limitele

Gestionați erorile HTTP standard: 401 pentru chei invalide, 402 pentru credit insuficient și 429 pentru limite de rată. Fereastra de context suportă un total de 100,000 de tokeni.

Ieșirea maximă este de 16.000 de token-uri per cerere. Erorile nu consumă credit. Ajustează-ți logica de reîncercare în funcție de codul de eroare.

cURL

Copycurl https://api.apikimi.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the key differences between Rust and Go memory management"}]
  }'

Python

Copyfrom openai import OpenAI

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

Node.js

Copyimport OpenAI from "openai";

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

Streaming

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)