Versione: 18 agosto 2026
Endpoint: POST https://api.logicc.cloud/v1/chat/completions
| Campo | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| model | string | Sì | ID di un modello restituito da GET /v1/models. |
| messages | array | Sì | Messaggi della conversazione che utilizzano role e content. |
| temperature | number | No | Controlla la variazione della risposta quando supportata dal modello. |
| max_tokens | integer | No | Numero massimo di token di output. |
| stream | boolean | No | Trasmette i token della risposta come server-sent events quando il valore è true. |
| tools | array | No | Definizioni di funzioni o strumenti per i modelli che supportano le chiamate agli strumenti. |
| tool_choice | string/object | No | Controlla facoltativamente se e quale strumento viene chiamato. |
Le chiamate agli strumenti sono disponibili quando supportate dal modello selezionato. Gli input degli strumenti devono sempre essere oggetti JSON validi. La compatibilità di parametri come reasoning_effort, output strutturato, vision e gestione dei file varia in base al modello.
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["LOGICC_API_KEY"],
base_url="https://api.logicc.cloud/v1",
)
response = client.chat.completions.create(
model="gpt-5-mini",
messages=[
{"role": "user", "content": "Write a concise project status update."}
],
)
print(response.choices[0].message.content)
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.LOGICC_API_KEY,
baseURL: "https://api.logicc.cloud/v1",
});
const response = await client.chat.completions.create({
model: "gpt-5-mini",
messages: [
{ role: "user", content: "Create a concise meeting summary." },
],
});
console.log(response.choices[0].message.content);
Impostate stream su true per ricevere server-sent events quando il modello selezionato supporta lo streaming. I client devono gestire blocchi parziali, interruzioni della connessione e un evento finale di completamento.
Endpoint: POST https://api.logicc.cloud/v1/embeddings
curl -X POST "https://api.logicc.cloud/v1/embeddings" \
-H "Authorization: Bearer $LOGICC_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "text-embedding-3-small",
"input": ["First document", "Second document"]
}'
Il modello di embedding deve essere abilitato per la chiave e restituito da GET /v1/models.
Endpoint: POST https://api.logicc.cloud/v1/audio/transcriptions
curl "https://api.logicc.cloud/v1/audio/transcriptions" \
-H "Authorization: Bearer $LOGICC_API_KEY" \
-F "model=azure/gpt-4o-transcribe" \
-F "[email protected]"
La richiesta utilizza multipart/form-data. I formati comuni includono MP3, MP4, MPEG, MPGA, M4A, WAV e WebM. A seconda del modello abilitato, i parametri facoltativi possono includere language, prompt e response_format.
| Campo | Tipo | Descrizione |
|---|---|---|
| id | string | ID univoco della richiesta o della completion. |
| model | string | Modello che ha elaborato la richiesta. |
| choices | array | Scelte di risposta generate. |
| choices[].message | object | Messaggio dell'assistente con contenuto ed eventuali chiamate agli strumenti. |
| choices[].finish_reason | string | Motivo dell'interruzione della generazione, ad esempio stop, length o tool_calls. |
| usage | object | Utilizzo dei token di prompt, completion e totali, quando restituito dal provider. |
Metadati specifici del provider possono essere restituiti in campi aggiuntivi, comprese le informazioni di routing, il modello risolto, la latenza e la risposta di errore originale.