Documentazione API Dolphin ai

Impostazione dell'URL di base e autenticazione

Le chiavi API autenticano istantaneamente le tue richieste prepagate. Ricevi una chiave attiva per account, che sostituisce qualsiasi chiave precedente alla generazione. L'URL di base punta al servizio ospitato.

• URL Base: HTTPS://api.aidolphin.cc/v1
• Intestazione: Authorization: Bearer YOUR_API_KEY

Copycurl https://api.aidolphin.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the top five open source inference engines"}]
  }'

Invio di una richiesta di completamento chat di base

Invia payload JSON standard all'endpoint delle chat completions. L'ID del modello è sempre "uncensored" per un output testuale coerente. I token di input costano $0.15 per milione, mentre i token di output costano $0.50 per milione.

• Modello: uncensored
• Output massimo: 16.000 token

Copyfrom openai import OpenAI

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

Risposte in streaming con Server-Sent Events

Abilita lo streaming impostando stream: true nella tua richiesta. L'API restituisce i dati tramite Server-Sent Events (SSE) per la consegna in tempo reale dei token. I dettagli sull'utilizzo dei token appaiono nell'ultimo chunk dello stream.

Copyimport OpenAI from "openai";

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

Attivazione della modalità JSON per dati strutturati

Usa response_format impostato a {"type": "json_object"} per forzare un output strutturato. Questo garantisce che il modello restituisca JSON valido senza formattazione markdown aggiuntiva. Il function calling e le definizioni degli strumenti si basano anche su questa struttura JSON.

Configurazione di temperature, top_p e sequenze di stop

Regola i parametri di campionamento per controllare la casualità e la lunghezza dell'output. Imposta temperature per la creatività, top_p per il campionamento nucleare, e stop sequenze per troncare l'output anticipatamente. Le penalità di presenza e frequenza aiutano a ridurre le ripetizioni.

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)

Comprendere i limiti di frequenza e le quote

Ogni chiave API consente 300 richieste al minuto e 8 richieste concorrenti. La dimensione massima del corpo della richiesta è di 8 MB. Errori e rifiuti non consumano il tuo credito prepagato. Se superi i limiti, ricevi un codice di stato 429.