IT ▾

Alternativa API AI senza censura per sviluppatori

https://api.veniceapialternative.com/v1

veniceapialternative.com

Endpoint API Venice AI: passa a un altro URL di base

Se il tuo codice punta a un endpoint API Venice AI e vuoi provare un altro provider, la modifica è minima: un URL di base, una chiave e un ID del modello. Questa pagina elenca cosa modificare, cosa testare e come cambia il comportamento dopo.

Aggiornato

Una spina di cavo che passa tra due blocchi server, che illustra un cambio di URL di base

Punti chiave

  • Quattro modifiche coprono la maggior parte delle migrazioni: URL di base, chiave API, ID del modello, gestione del saldo.
  • Il nuovo URL di base è https://api.veniceapialternative.com/v1 e l'ID del modello è uncensored.
  • Sono supportati tre endpoint: chat completions, responses e models.
  • Fai un test con il trial da $0,50 prima di spostare il traffico reale.

La risposta breve: quattro modifiche

Qualsiasi client che parla il formato chat OpenAI ha bisogno solo di modifiche alla configurazione per raggiungere un provider diverso. Per un endpoint API di venice ai, vale lo stesso principio al contrario: stai sostituendo quattro valori, non riscrivendo la tua integrazione.

  1. URL di base: impostalo su https://api.veniceapialternative.com/v1.
  2. Chiave API: creane una nella pagina delle chiavi API e inviala come Authorization: Bearer <key>.
  3. ID del modello: usa uncensored. C'è un unico modello, quindi non c'è una lista di modelli da mappare.
  4. Controlli del saldo: leggi l'intestazione X-Balance-USD, oppure chiama GET /v1/balance.

Questo è un servizio indipendente, non gestito o affiliato a Venice o ad altri fornitori. Ospita un unico modello a pesi aperti, quindi qualsiasi nome di modello usato dal tuo codice in precedenza deve essere sostituito.

Prima di modificare: trova ogni punto in cui vive l'endpoint

L'URL di base raramente si trova in un solo file. Cerca nel tuo repository il vecchio nome host, la vecchia stringa del modello e la variabile d'ambiente che contiene la chiave. I luoghi tipici sono i costruttori SDK, i file .env, i segreti Docker o CI, le configurazioni front-end e i worker in background scritti separatamente dall'app principale.

Un'abitudine utile è spostare tutti e tre i valori nelle variabili d'ambiente prima di migrare. Questo rende il passaggio una modifica in fase di deploy e ti offre un rollback in una sola riga.

export LLM_BASE_URL="https://api.veniceapialternative.com/v1"
export LLM_API_KEY="YOUR_KEY"
export LLM_MODEL="uncensored"

Codice per Python, Node e curl

Python (SDK openai)

import os
from openai import OpenAI

client = OpenAI(
    base_url=os.environ.get("LLM_BASE_URL", "https://api.veniceapialternative.com/v1"),
    api_key=os.environ["LLM_API_KEY"],
)

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Say hello in five words."}],
)
print(resp.choices[0].message.content)

Node.js

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.veniceapialternative.com/v1",
  apiKey: process.env.LLM_API_KEY,
});

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Say hello in five words." }],
});
console.log(resp.choices[0].message.content);

curl

curl -i https://api.veniceapialternative.com/v1/chat/completions \
  -H "Authorization: Bearer $LLM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"Say hello in five words."}]}'

Il flag -i stampa le intestazioni di risposta, il modo in cui vedi X-Request-Id e X-Balance-USD alla prima chiamata.

Cosa resta uguale e cosa cambia

La forma della richiesta è quella familiare: messages con ruoli, stream, tools, tool_choice, response_format per la modalità JSON, e i parametri di campionamento temperature, top_p, stop, seed e le penalità. Lo streaming usa SSE con l'utilizzo alla fine, e i risultati degli strumenti tornano come messaggi role: "tool".

VoceQui
EndpointPOST /v1/chat/completions, POST /v1/responses, GET /v1/models
ID modellouncensored (un modello)
Finestra di contesto100.000 token, prompt più completamento
Dimensione massima del corpo della richiesta8 MB
ModalitàSolo testo: nessuna immagine, audio, video, embedding o fine-tuning

L'ultima riga è quella che rompe le migrazioni. Se la tua app chiama un percorso per immagini, voce o embedding sul vecchio provider, quelle chiamate non hanno un equivalente qui. Mantieni quella parte sul provider corrente e sposta solo le chiamate per il testo.

Gestisci limiti ed errori in modo diverso

Una chiave completa permette 8 richieste concorrenti e 300 richieste al minuto. Una chiave trial permette 2 concorrenti e 60 al minuto. Superato uno qualsiasi di questi limiti ricevi un HTTP 429, con codice di errore rate_limited per le richieste al minuto o concurrency per troppe richieste simultanee. Un 429 con l'intestazione Retry-After: 5 indica un sovraccarico temporaneo: attendi e riprova.

Nota che una richiesta in streaming occupa la sua posizione di concorrenza fino al termine dello streaming. Se la tua vecchia integrazione ha inviato decine di chiamate parallele, inserisci un semaforo con un limite di 8 o meno davanti al client.

import time, random
from openai import OpenAI, RateLimitError

client = OpenAI(base_url="https://api.veniceapialternative.com/v1", api_key="YOUR_KEY")

def ask(prompt, tries=4):
    for i in range(tries):
        try:
            r = client.chat.completions.create(
                model="uncensored",
                messages=[{"role": "user", "content": prompt}],
            )
            return r.choices[0].message.content
        except RateLimitError:
            time.sleep(5 + random.random() * i)
    raise RuntimeError("still rate limited")

Le richieste fallite o rifiutate non vengono addebitate, quindi i retry per errori non ti costano credito.

Streaming e chiamate di funzioni dopo il passaggio

Se la tua app trasmette token a un'interfaccia utente, non cambia nulla nel client: imposta stream: true e leggi gli eventi inviati dal server. Il blocco di utilizzo arriva alla fine dello streaming, il che è utile per registrare il costo di ogni risposta.

from openai import OpenAI

client = OpenAI(base_url="https://api.veniceapialternative.com/v1", api_key="YOUR_KEY")

stream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "List three uses of a message queue."}],
    stream=True,
    stream_options={"include_usage": True},
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="")
    if chunk.usage:
        print("\n", chunk.usage)

La chiamata di funzioni segue il flusso che già conosci. Passi tools e opzionalmente tool_choice, il modello restituisce tool_calls (in streaming, frammentato quando attivo), esegui la funzione e invii il risultato come messaggio role: "tool". La modalità JSON funziona con response_format: {"type": "json_object"}. Convalida sempre il JSON analizzato nel tuo codice, perché nessun modello garantisce uno schema.

Problemi comuni dopo il passaggio

  • Errori di autenticazione. Verifica che la chiave sia inviata come token Bearer e che tu abbia copiato l'intera stringa. Una chiave del vecchio provider non funzionerà qui.
  • Errori di non trovato. L'URL di base deve terminare con /v1. Se incolli l'intero percorso /chat/completions in un SDK che lo aggiunge di nuovo, il percorso sarà errato.
  • Modello sconosciuto. Qualsiasi stringa del modello diversa da uncensored è errata. Cerca i nomi hard-coded nelle configurazioni e nei test.
  • Picchi di 429. Limita il parallelismo alla concorrenza del tipo di chiave e rispetta Retry-After.
  • Costo imprevisto. Le cronologie di chat lunghe vengono fatturate come input ad ogni turno. Tagliale.

Se qualcosa sembra ancora sbagliato, invia il valore X-Request-Id dalla risposta alla pagina di supporto. Identifica la richiesta esatta e fa risparmiare tempo a entrambe le parti.

Checklist di migrazione e test

Segui questa procedura in ordine. Ogni passaggio è una modifica piccola e reversibile.

  1. Richiedi il trial da $0,50 dalla pagina delle chiavi API. Non richiede una carta e dura 7 giorni.
  2. Esegui la chiamata curl sopra e conferma la risposta e le intestazioni.
  3. Passa un percorso di codice non critico al nuovo URL di base e alla nuova chiave.
  4. Riproduci un campione di prompt reali e confronta la qualità, la lunghezza e la latenza dell'output a occhio.
  5. Controlla usage nelle risposte e moltiplica per il tuo volume a $0.15 per 1M di input e $0.50 per 1M di output tokens.
  6. Aggiungi un avviso di saldo su X-Balance-USD.
  7. Ricarica (da $20, con bonus da $50) e sposta il resto del traffico.

I prompt che dipendevano dalle particolarità di un altro modello potrebbero richiedere piccole modifiche, come un prompt di sistema diverso. È normale quando si cambiano modello, quindi giudica sul tuo set di test, non su una singola risposta. Questo modello è ottimizzato per rispondere senza rifiuti di contenuto per uso adulto legale e i contenuti sessuali che coinvolgono minorenni non sono consentiti.

Le docs descrivono ogni endpoint e intestazione. La nostra pagina sull'alternativa API Venice copre come il prodotto si confronta, e la pagina dei prezzi mostra gli importi di ricarica, i bonus e i metodi di pagamento. I prompt inviati all'API non sono usati per l'addestramento e il credito non scade mai, quindi una piccola ricarica di test non ha scadenza.

Domande e risposte

Cos'è l'URL base?

Usa https://api.veniceapialternative.com/v1 con qualsiasi client compatibile con OpenAI e invia la tua chiave come un token Bearer.

Quale ID modello devo inviare?

Invia uncensored. C'è un solo modello, quindi non c'è nulla da mappare dai nomi dei tuoi vecchi modelli.

Come posso verificare il mio saldo?

Leggi l'intestazione di risposta X-Balance-USD, chiama GET /v1/balance oppure usa GET /v1/dashboard/billing/credit_grants nello stile OpenAI.

Posso chiamare gli endpoint per immagini o embedding?

No. L'API è solo testo, senza endpoint per immagini, audio, video, embedding o fine-tuning.

La tua chiave è a un modulo di distanza

Crea un account, copia la chiave, cambia l'URL di base. È tutta la configurazione.

Ottieni la chiave API