Documentação da API

A API FioriAI é compatível com o formato OpenAI. Use o SDK oficial ou qualquer cliente HTTP.

Início rápido

A chave de API é obtida no Dashboard após o login. Nunca exponha sua chave em repositórios ou no frontend.

Base URL

https://fiori-ai.com/api/v1

Autenticação

Envie a chave no header Authorization com o prefixo Bearer:

Authorization: Bearer sua_chave_api

Cline (VS Code)

Para usar no Cline com provider OpenAI Compatible, preencha:

• Base URL: https://fiori-ai.com/api/v1
• API Key: sua chave criada no Dashboard
• Model ID: fiori-coder

Se preferir configurar direto no settings.json:

"cline.apiProvider": "openai",
"cline.openai": {
  "apiKey": "sua_chave_api",
  "baseURL": "https://fiori-ai.com/api/v1"
},
"cline.defaultModel": "fiori-coder"

Modelos

Use o parâmetro model com um dos identificadores abaixo. Endpoints compatíveis com OpenAI:

• GET /v1/models — lista de modelos ativos
• GET /v1/models/{id} — detalhe de um modelo (ex.: fiori-coder)

Cada requisição de chat debita créditos conforme o modelo:

Chat Completions

Endpoint principal para geração de texto. Suporta stream: true para respostas em tempo real.

Requisição

POST /v1/chat/completions

Parâmetros principais

• model — Identificador do modelo (obrigatório)
• messages — Array de mensagens com role e content. content pode ser string ou array de partes (OpenAI). Inclua role: "system" para instruções ao modelo. Suporta name, tool_call_id e tool_calls para function calling.
• stream — true para streaming via SSE
• max_tokens / max_completion_tokens — Limite de tokens na resposta
• temperature — Aleatoriedade (0 a 2)
• top_p — Amostragem nucleus (0 a 1)
• stop — String ou lista de strings para parada
• n — Número de respostas a gerar
• presence_penalty, frequency_penalty — Penalidades (-2 a 2)
• logit_bias — Ajuste de logits por token
• response_format — Formato de resposta (ex.: JSON)
• tools, tool_choice, parallel_tool_calls — Function calling
• user — Identificador do usuário (opcional)
• seed — Semente para reprodutibilidade
• reasoning_effort — Esforço de raciocínio (low, medium, high)

Exemplos

cURL

curl -X POST "https://fiori-ai.com/api/v1/chat/completions" \
  -H "Authorization: Bearer sua_chave_api" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "fiori-a1",
    "messages": [
      {"role": "user", "content": "Olá, como você pode ajudar?"}
    ]
  }'

Python (OpenAI SDK)

from openai import OpenAI

# Use variável de ambiente em produção
client = OpenAI(
    base_url="https://fiori-ai.com/api/v1",
    api_key="sua_chave_api",  # ou os.getenv("FIORI_API_KEY")
)

response = client.chat.completions.create(
    model="fiori-a1",
    messages=[{"role": "user", "content": "Olá"}]
)
print(response.choices[0].message.content)

JavaScript / Node.js

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://fiori-ai.com/api/v1",
  apiKey: process.env.FIORI_API_KEY,  // nunca hardcode
});

const response = await client.chat.completions.create({
  model: "fiori-a1",
  messages: [{ role: "user", content: "Resumo deste texto..." }],
});

console.log(response.choices[0].message.content);

Respostas de erro

Erros seguem o formato OpenAI com error.message, error.type e error.code:

• invalid_api_key (401) — Token inválido ou expirado
• insufficient_credits (402) — Créditos insuficientes
• model_not_found (404) — Modelo indisponível
• provider_not_supported (400) — Provider do modelo não suportado
• provider_not_configured (500) — Chave do provider (ex. Groq) não configurada no servidor