Przewodnik integracji dla programistów

Uwierzytelnianie i konfiguracja URL bazowego

Zacznij od wygenerowania swojego klucza API na panelu. Podstawowy adres URL to HTTPS://api.apiaicheap.com/v1. Przekaż swój klucz w nagłówku Authorization jako token bearer.

• Kliknij "Pobierz klucz API" i zaloguj się za pomocą Google lub e-maila.
• Skopiuj klucz natychmiast; jest wyświetlany tylko raz.

Ten klucz uwierzytelnia wszystkie żądania do punktu końcowego uzupełnień czatu.

Przykładowy nagłówek

Autoryzacja: Bearer TWOJ_KLUCZ_API

Pierwsze żądanie z użyciem cURL

Wyślij podstawowe ukończenie czatu, aby przetestować swoją konfigurację. Użyj endpointu POST /v1/chat/completions z modelem "uncensored".

To potwierdza Twój stan konta kredytowego i opóźnienie.

• Ustaw rolę na "user".
• Utrzymaj wiadomość prostą dla pierwszego testu.

Sprawdź odpowiedź pod kątem pola z wygenerowanym tekstem.

• Szukaj wartości "content".

Jeśli otrzymasz odpowiedź 200 OK, Twoja integracja działa poprawnie.

Copycurl https://api.apiaicheap.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Fix the null pointer in the login handler"}]
  }'

Integracja Python SDK

Użyj oficjalnej biblioteki Pythona OpenAI dla łatwej integracji. Wskaż ją na nasz base URL i ustaw swój klucz API.

To podejście automatycznie obsługuje ponawianie prób i parsowanie JSON.

• Zainstaluj bibliotekę za pomocą pip.
• Ustaw parametr base_url na nasz punkt końcowy.

Wywołaj metodę chat.completions.create.

Przekazaj swoją listę wiadomości jako argument.

• Dołącz nazwę modelu „uncensored”.

Skorzystaj z tekstu odpowiedzi poprzez atrybuty obiektu.

Ta metoda jest czysta i czytelna dla skryptów produkcyjnych.

Copyfrom openai import OpenAI

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

Konfiguracja SDK Node.js

SDK Node.js działa podobnie jak wersja Pythona. Zainicjuj klienta swoim kluczem i naszym URL bazowym.

To pozwala używać znanych wzorców async/await.

• Zaimportuj pakiet OpenAI.
• Skonfiguruj adres URL bazowy w konstruktorze.

Utwórz żądanie completion z swoimi wiadomościami.

Obsługuj obietnicę, aby uzyskać wynik.

• Wydobywaj treść wiadomości z odpowiedzi.

Zaloguj wyjście, aby zweryfikować, czy model odpowiada poprawnie.

To rozwiązanie jest idealne dla serwerów sieciowych i usług backendowych.

Copyimport OpenAI from "openai";

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

Strumieniowanie odpowiedzi z SSE

Włącz strumieniowanie, ustawiając stream na true w żądaniu. API zwraca fragmenty w miarę ich generowania za pomocą zdarzeń wysyłanych serwerowo (SSE).

To zmniejsza postrzeganą latencję dla użytkowników w aplikacjach czatu.

• Ustaw stream: true w ładunku.
• Przetwarzaj każdy fragment w miarę jego napływania.

Połącz fragmenty, aby utworzyć ostateczną odpowiedź.

Szczegóły zużycia tokenów pojawiają się w ostatnim fragmencie.

• Sprawdź pole "usage" w ostatnim kawałku.

To podejście utrzymuje responsywność interfejsu użytkownika podczas długich generacji.

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)

Limity, błędy i okno kontekstu

Twoje konto ma limit 300 żądań na minutę na klucz. Okno kontekstowe obsługuje 100 000 tokenów łącznie dla promptu i uzupełnienia.

Błędy są obsługiwane za pośrednictwem standardowych kodów statusu HTTP.

• 401 oznacza nieprawidłowy lub brakujący klucz API.
• 402 oznacza, że Twój kredyt prepay został wyczerpany.
• 429 sygnalizuje, że przekroczyłeś limit szybkości.

Odmowy nie kosztują kredytu. Błędy są również darmowe.

Maks. wyjście to 16,000 tokenów na żądanie. Ustaw max_tokens, jeśli potrzebujesz mniej.

Ta struktura zapewnia przewidywalne rozliczenia i wydajność.