Início Rápido da API Dolphin AI

Autenticação e URL Base

Sua chave de API autentica cada solicitação. Use a URL base https://api.dolphinaimodels.com/v1 para todos os endpoints. O sistema requer uma chave válida no Authorization cabeçalho. Sem isso, as requisições falham imediatamente.

Gere sua chave pelo painel. Você recebe uma chave ativa por conta. Substitua sua chave antiga se gerar uma nova. A chave concede acesso imediato ao modelo sem censura.

Enviando uma Solicitação de Conclusão de Chat

Envie uma requisição POST para /v1/chat/completions. O ID do modelo é uncensored. Esse endpoint lida com entrada de texto e retorna saída de texto. Você pode ajustar parâmetros como temperatura e top_p.

Aqui está um exemplo básico de cURL para começar:

Copycurl https://api.dolphinaimodels.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Summit elevation is 29032 feet."}]
  }'

Integração do SDK Python

Use a biblioteca Python oficial da OpenAI. Aponte-a para a nossa URL base. Passe sua chave da API. A estrutura do código espelha o uso padrão da OpenAI. Isso garante uma migração fácil para projetos existentes.

Configure o cliente com estes valores:

Copyfrom openai import OpenAI

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

Configuração do SDK Node

Inicialize o cliente Node.js da mesma forma. Defina a URL base e a chave da API. O SDK cuida da serialização automaticamente. Esta abordagem funciona tanto para aplicações server-side quanto client-side.

Configuração de exemplo:

Copyimport OpenAI from "openai";

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

Lidando com Respostas de Streaming

Ative o streaming definindo stream: true. A API retorna Server-Sent Events (SSE). Cada fragmento contém texto parcial. O último fragmento inclui dados de uso de tokens. Isso reduz a latência percebida para os usuários.

Transmita a resposta:

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)

Entendendo Limites e Erros

A janela de contexto é de 100.000 tokens. Isso inclui prompt e conclusão. A saída máxima é de 16.000 tokens por solicitação. Erros retornam códigos HTTP padrão. 401 indica uma chave inválida. 402 significa crédito insuficiente. 429 sinaliza limite de taxa atingido.

Você está limitado a 300 solicitações por minuto. A concorrência é limitada a 8 solicitações simultâneas. Mantenha os corpos das solicitações abaixo de 8 MB. Esses limites garantem um desempenho estável para sua carga de trabalho.