Dolphin AI API Quickstart

Perus-URL & todennus

Aloita asettamalla perus-URL-osoitteesi ja API-avaimesi asiakasasetuksissa. Kaikki pyynnöt todennetaan Authorization header käyttäen ainutlaatuista avaintasi. Palvelumme toimitsen riippumattomana tarjoajana openrouter dolphin AI malli variantti, mikä tarkoittaa, ettet tarvitse OpenRouter-tiliä käyttääksesi tätä päätepistettä. Hae avain hallintapaneelista ja liitä se ympäristömuuttujiisi.

• Base URL: https://api.openrouterdolphinai.com/v1
• Otsake: Authorization: Bearer YOUR_API_KEY

Tämä konfiguraatio toimii minkä tahansa vakiintuneen OpenAI SDK:n kanssa, koska jäljitämme niiden tarkan päätepisterakenteen. Vuorovaikutuksesi rajoittuu chat-completions -päätepisteeseen, pitäen integraatiosi yksinkertaisena ja keskittyneenä tekstin generointiin.

Ensimmäinen pyyntö

Lähetä ensimmäinen viesti tekstin luomiseksi yksinkertaisella POST metodi. Mallin tunnus on aina uncensored, joka varmistaa, että saat nimenomaisen uncensored-mallin, joka on hienosäädetty rajoittamattomaan vuoropuheluun. Sinun ei tarvitse määrittää monimutkaisia reititysparametreja, koska isännöimme tätä yhtä mallia suoraan.

Käytä seuraavaa curl-komentoa testataksesi yhteyttäsi välittömästi:

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"}]
  }'

Jos saat JSON-vastauksen, jossa on sisältöä, avaimesi on aktiivinen ja krediiitit vähennetään oikein. Virheet kuten 401 viittaavat virheelliseen avaimiin, kun taas 402 tarkoittaa, että sinun täytyy täyttää saldoa kryptolla. Tämä suora lähestymistapa välttää monimallisten reitittimien vaihteluvaihtelut.

Python SDK -integraatio

Integroituminen nopeasti käyttämällä virallista OpenAI Python -kirjastoa osoittamalla se perus-URL:iimme. Tämä mahdollistaa tutkujen menetelmien käytön, kuten chat.completions.create() uudelleenkirjoittamatta koko logiikkaa. Kirjasto hoitaa serialisoinnin automaattisesti, joten voit keskittyä prompt-suunnitteluun HTTP-yksityiskohtien sijaan.

Määritä asiakas perus-URL-osoitteesi ja avaimen kanssa:

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)

Muista, että kontekstiikkunamme on 100 000 tokenia, joten voit välittää merkittävän keskusteluhistorian. SDK käsittelee tokenisoinnin ja lähetyksen tehokkaasti, varmistaen, että ohjeistuksesi saavuttavat mallin ilman tarpeetonta ylikuormitusta tai muotoiluvirheitä.

Node SDK -käyttö

Node-kehittäjät voivat saavuttaa saman tuloksen käyttämällä openai npm-paketti. Aivan kuten Python-versiossa, sinun on ylikirjoitettava oletusperus-URL osoittamaan omille omille palvelimillemme. Tämä varmistaa, että pyyntösi menevät suoraan rajoittamattomaan malliin osumatta kolmannen osapuolen nopeusrajoituksiin tai reititysviiveisiin.

Alusta asiakasohjelma oikealla päätepisteellä:

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);

Tämä kuvio toimii sekä synkronisissa kutsuissa että async/await-kuvioissa. Voit suoratoistaa vastauksia tai pyytää JSON-tilaa suoraan samassa funktiokutsussa, mikä antaa joustavuutta eri sovellusarkkitehtuureille ilman, että sinun tarvitsee muuttaa ydintodennusasetuksia.

Streamausvastaukset

Ota käyttöön reaaliaikainen tekstin generointi asettamalla stream: true pyyntöparametreissa. Sovellusliittymä palauttaa Server-Sent Events (SSE) -virran, joka mahdollistaa tokenien näyttämisen tuotannon aikana. Tämä vähentää käyttäjien kokemaa viiveellisyyttä, jolloin kokemus tuntuu paljon nopeammalta kuin koko vastauksen odottaminen.

Käsittele virtalohkoja kertyttääksesi lopullisen tekstin:

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)

Jokainen palikka sisältää token-käyttötiedot viimeisessä osassa, joten voit seurata kustannuksia tarkasti. Streamaus on ihanteellinen chat-käyttöliittymille, joissa välitön palaute parantaa käyttäjien sitoutumista. Voit keskeyttää streamin milloin tahansa, jos käyttäjä lähettää uuden viestin, säästäen kolikoita osittaisista vastauksista.

Rajoitukset, virheet & konteksti

Ymmärrä tekniset rajat välttääksesi odottamattomat keskeytykset sovelluksessasi. APIemme asettaa 100 000 tokennin kontekstikkoneen jokaiseen pyyntöön, yhdistäen sekä syötteen että täydennyksen. Jos ylität 16 000 tokenin lähtörajan, generointi pysähtyy, joten aseta max_tokens siten kustannusten hallitsemiseksi.

Yleiset HTTP-vastauskoodit sisältävät 401 virallisista avaimista, 402 riittämättömästä saldotilasta ja 429 nopeusrajoituksista. Sinulla on rajoitus 300 pyyntöä minuutissa avainta kohden. Nämä rajoitukset varmistavat reilun käytön kaikille käyttäjille. Käytä 429 virhe toteuttaa eksponentiaalisen taaksepäin siirtymisen asiakaskoodissasi varmistaaksesi sujuvan toiminnan ruuhka-aikoina.