Dolphin AI API Gyors kezdés

Base URL & Hitelesítés

Kezdje azzal, hogy a base URL-t és az API kulcsot a kliens konfigurációjában állítja be. Minden kérés a Authorization fej egyedi kulcsával. Szolgáltatásunk független szolgáltatóként működik a openrouter dolphin AI a modell variáns, ami azt jelenti, hogy nem szükséges fiókja az OpenRouter-nál ehhez a végponthoz. Egyszerűen szerezze meg a kulcsát a dashboardról, és illessze be a környezeti változókba.

• Base URL: https://api.openrouterdolphinai.com/v1
• Fejléc: Authorization: Bearer YOUR_API_KEY

Ez a beállítás működik bármely szabványos OpenAI SDK-val, mert pontosan utánozzuk a végpontjaik szerkezetét. Csak a chat completions végponttal fog interakcióba lépni, így az integráció egyszerű marad és a szöveggenerálásra fókuszál.

Első kérés

Küldje el az első üzenetet szöveg generálásához a egyszerű POST módszer. A modell azonosítója mindig uncensored, amely biztosítja, hogy a korlátlan párbeszédre hangolt specifikus uncensored változatot kapja. Nem kell bonyolult routing paramétereket megadnia, mivel ezt az egyetlen modellt közvetlenül hosztoljuk.

Használja az alábbi curl parancsot a kapcsolódás azonnali teszteléséhez:

Copycurl https://api.openrouterdolphinai.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Fix the syntax error in this python function"}]
  }'

Ha JSON választ kap tartalommal, a kulcsa aktív és a kreditek helyesen kerülnek levonásra. A 401-es hibák érvénytelen kulcsot jeleznek, míg a 402-es azt jelenti, hogy töltenie kell fel a számláját kriptovalutával. Ez a közvetlen megközelítés elkerüli a több modellt használó routerek változékonyságát.

Python SDK Integráció

Gyors integráció a hivatalos OpenAI Python könyvtárral, amely a base URL-re mutat. Ez lehetővé teszi a jól ismert módszerek használatát, mint például chat.completions.create() az egész logika átírása nélkül. A könyvtár automatikusan kezeli a szerializálást, így a prompt tervezésére koncentrálhat az HTTP részletek helyett.

Konfigurálja az ügyfélt az alap URL-vel és a kulccsal:

Copyfrom openai import OpenAI

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

Emlékezzen, hogy a kontextusablakunk 100,000 token, így jelentős beszélgetési előzményeket adhat át. Az SDK hatékonyan kezeli a tokenizálást és a továbbítást, biztosítva, hogy a promptok eljussanak a modellhez felesleges terhelés vagy formázási hibák nélkül.

Node SDK használat

A Node fejlesztők ugyanazt az eredményt érhetik el a openai npm csomagot. Mint a Python verzió esetén, felül kell írnod a gyári bázis URL-t, hogy a dedikált szervereinkre mutasson. Ez biztosítja, hogy a kérések közvetlenül a szűrés nélküli modellhez kerüljenek, harmadik fél által okozott sebességkorlátozások vagy átirányítási késések nélkül.

Inicializálja a klienst a helyes végpontra:

Copyimport OpenAI from "openai";

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

Ez a minta mind szinkron hívásokhoz, mind az async/await mintákhoz működik. Streamelheti a válaszokat vagy kérhet JSON módot közvetlenül ugyanazon a függvényhíváson belül, ami rugalmasságot biztosít különböző alkalmazásarchitektúrákhoz a alapvető hitelesítési beállítások megváltoztatása nélkül.

Streamelési válaszok

Valós idejű szöveggenerálás engedélyezése ezzel stream: true a kérés paramétereiben. Az API Server-Sent Events (SSE) streamet ad vissza, amely lehetővé teszi a tokenek megjelenítését generálás közben. Ez csökkenti az érzékelt késleltetést a felhasználók számára, így az élmény sokkal gyorsabbnak tűnik, mint egy teljes válaszra várva.

Kezelje a stream darabjait a végső szöveg felhalmozásához:

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)

Minden chunk tokenfelhasználási adatot tartalmaz a végső részben, így pontosan nyomon követheti a költségeket. A streamelés ideális chat felületekhez, ahol az azonnali visszajelzés javítja a felhasználói elköteleződést. Bármikor leállíthatja a streamet, ha a felhasználó új üzenetet küld, így megtakarítva a hitelt a részleges válaszoknál.

Korlátok, hibák & Kontextus

Értsd meg a technikai határokat a váratlan megszakítások elkerülése érdekében. API-nk 100 000 tokenes kontextusablakot alkalmaz minden kérésre, amely magában foglalja a promptot és a kiegészítést. Ha túlléped a 16 000 tokenes kimeneti korlátot, a generálás leáll, ezért állítsd be max_tokens a költségek kontrollálásának megfelelően.

A gyakori HTTP státuszkódok közé tartozik a 401 az érvénytelen kulcsokhoz, a 402 az elégtelen hitelhez és a 429 a rate limitekhez. Kulcsonként percenként 300 kérésre van korlátozva. Ezek a korlátok biztosítják a tisztességes felhasználást minden felhasználó számára. Használja a 429 hiba a kliens kódjában exponenciális visszatérési stratégia (exponential backoff) megvalósításához, a csúcsforgalom alatti zökkenőmentes működés biztosítása érdekében.