✦ Cosmic API Gateway

Interface de programação para modelos de inteligência artificial

v2.0 — Multi-Modal

🚀 Playground

💬 Texto

🖼 Imagem

🎵 Áudio

🔢 Embeddings

🌐 Tradução

📋 Modelos

🔑 Autenticação

🚀 Playground Interativo

Teste os modelos gratuitamente — sem precisar de chave de API

5 testes gratuitos disponíveis por IP a cada 24h

Modelo

Mensagem

Resultado

🧠 Usando o cosmic-v2 — Nossa IA com Aprendizado Contínuo

O cosmic-v2 é nossa IA própria. Ela aprende com cada interação: na primeira vez consulta os modelos professores, nas próximas responde do cache semântico — cada vez mais rápida e inteligente.

Exemplo cURL — cosmic-v2

curl -X POST https://cosmic.ia.br/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer SUA_CHAVE_LOCAL" \
  -d '{
    "model": "cosmic-v2",
    "messages": [
      {"role": "system", "content": "Você é um assistente útil."},
      {"role": "user", "content": "Explique machine learning em 2 linhas."}
    ],
    "max_tokens": 300
  }'

Exemplo Python — cosmic-v2

from openai import OpenAI

client = OpenAI(
    base_url="https://cosmic.ia.br/v1",
    api_key="SUA_CHAVE_LOCAL"
)

response = client.chat.completions.create(
    model="cosmic-v2",
    messages=[
        {"role": "system", "content": "Você é um assistente útil."},
        {"role": "user", "content": "O que é inteligência artificial?"}
    ],
    max_tokens=300
)

print(response.choices[0].message.content)
# Verificar de onde veio a resposta:
# response.model_extra.get('cosmic_v2', {})

Exemplo JavaScript / Node.js — cosmic-v2

const response = await fetch('https://cosmic.ia.br/v1/chat/completions', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer SUA_CHAVE_LOCAL'
  },
  body: JSON.stringify({
    model: 'cosmic-v2',
    messages: [
      { role: 'user', content: 'Explique machine learning em 2 linhas.' }
    ],
    max_tokens: 300
  })
});

const data = await response.json();
console.log(data.choices[0].message.content);
// data.cosmic_v2.source → 'cache_hit' | 'student' | 'professor'

Exemplo PHP — cosmic-v2

$ch = curl_init('https://cosmic.ia.br/v1/chat/completions');
curl_setopt_array($ch, [
  CURLOPT_POST => true,
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => [
    'Content-Type: application/json',
    'Authorization: Bearer SUA_CHAVE_LOCAL',
  ],
  CURLOPT_POSTFIELDS => json_encode([
    'model' => 'cosmic-v2',
    'messages' => [
      ['role' => 'user', 'content' => 'O que é IA?']
    ],
    'max_tokens' => 300,
  ]),
]);
$response = json_decode(curl_exec($ch), true);
echo $response['choices'][0]['message']['content'];
// $response['cosmic_v2']['source'] → 'cache_hit' | 'student' | 'professor'

💡 Dica: A resposta inclui o campo cosmic_v2.source indicando a origem: cache_hit (do cache — instantâneo), student (IA aluna respondeu sozinha) ou professor / professor_advanced (consultou o modelo professor e aprendeu).

POST/v1/chat/completions

Geração de texto compatível com o formato OpenAI Chat Completions. Suporta múltiplos modelos com mapeamento automático.

Ver exemplo cURL

curl -X POST https://cosmic.ia.br/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer SUA_CHAVE_LOCAL" \
  -d '{
    "model": "gpt-5.6-sol",
    "messages": [
      {"role": "system", "content": "Você é um assistente útil."},
      {"role": "user", "content": "Explique machine learning em 2 linhas."}
    ],
    "max_tokens": 200
  }'

Ver exemplo PHP

$ch = curl_init('https://cosmic.ia.br/v1/chat/completions');
curl_setopt_array($ch, [
  CURLOPT_POST => true,
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => [
    'Content-Type: application/json',
    'Authorization: Bearer SUA_CHAVE_LOCAL',
  ],
  CURLOPT_POSTFIELDS => json_encode([
    'model' => 'gpt-4o-mini',
    'messages' => [
      ['role' => 'user', 'content' => 'Olá!']
    ],
    'max_tokens' => 200,
  ]),
]);
$response = json_decode(curl_exec($ch), true);
echo $response['choices'][0]['message']['content'];

Parâmetros

Campo	Tipo	Descrição
model	string	ID do modelo (ex: gpt-4o-mini, cosmic-pro)
messages	array	Array de mensagens {role, content}
max_tokens	integer	Máximo de tokens na resposta (padrão: 1024, máx: 2048)
temperature	float	Criatividade 0.0–2.0 (padrão: 1.0)
stream	boolean	Streaming de resposta (padrão: false)

POST/v1/images/generations

Geração de imagens a partir de texto. Retorna a imagem em base64.

Ver exemplo cURL

curl -X POST https://cosmic.ia.br/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer SUA_CHAVE_LOCAL" \
  -d '{
    "prompt": "A futuristic city at night, neon lights, ultra detailed",
    "model": "flux-1-schnell",
    "n": 1
  }'

Modelos de Imagem

Modelo	Descrição	Tipo
flux-1-schnell	FLUX.1 Schnell — ultra rápido, alta qualidade	Gratuito
dreamshaper-8-lcm	DreamShaper 8 — fotorrealismo	Gratuito
stable-diffusion-xl-base-1.0	SDXL Base — qualidade premium	Gratuito
stable-diffusion-xl-lightning	SDXL Lightning — rápido, 1024px	Gratuito

POST/v1/audio/speech — Text-to-Speech

Converte texto em áudio. Retorna arquivo MP3 em base64.

Ver exemplo cURL

curl -X POST https://cosmic.ia.br/v1/audio/speech \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer SUA_CHAVE_LOCAL" \
  -d '{
    "model": "aura-2-es",
    "input": "Bem-vindo ao Cosmic API Gateway.",
    "voice": "asteria"
  }'

POST/v1/audio/transcriptions — Speech-to-Text

Transcreve áudio para texto usando o modelo definido no Mapeamento de Modelos. Envie o arquivo como multipart/form-data.

Ver exemplo cURL

curl -X POST https://cosmic.ia.br/v1/audio/transcriptions \
  -H "Authorization: Bearer SUA_CHAVE_LOCAL" \
  -F "file=@reuniao.mp3" \
  -F "model=whisper-large-v3-turbo" \
  -F "language=pt" \
  -F "vad_filter=true"

Modelos de Áudio

Modelo	Tipo	Idioma
aura-2-es	TTS	Português / Espanhol
aura-2-en	TTS	Inglês
aura-1	TTS	Inglês
whisper	ASR	Multilingual
whisper-large-v3-turbo	ASR	Multilingual

🧠 Embeddings com cosmic-v2

Use cosmic-v2 como modelo de embeddings. Internamente usa o bge-base-en-v1.5 (768 dimensões) e registra o uso para aprendizado contínuo.

Exemplo cURL — cosmic-v2 Embeddings

curl -X POST https://cosmic.ia.br/v1/embeddings \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer SUA_CHAVE_LOCAL" \
  -d '{
    "model": "cosmic-v2",
    "input": "Texto para gerar embedding"
  }'

Exemplo Python — cosmic-v2 Embeddings

from openai import OpenAI

client = OpenAI(
    base_url="https://cosmic.ia.br/v1",
    api_key="SUA_CHAVE_LOCAL"
)

response = client.embeddings.create(
    model="cosmic-v2",
    input="Texto para gerar embedding"
)

vector = response.data[0].embedding
print(f"Vetor com {len(vector)} dimensões")

Exemplo JavaScript — cosmic-v2 Embeddings

const response = await fetch('https://cosmic.ia.br/v1/embeddings', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer SUA_CHAVE_LOCAL'
  },
  body: JSON.stringify({
    model: 'cosmic-v2',
    input: 'Texto para gerar embedding'
  })
});

const data = await response.json();
const vector = data.data[0].embedding;
console.log('Dimensões:', vector.length); // 768

POST/v1/embeddings

Gera vetores de embeddings para uso em busca semântica, RAG e classificação.

Ver exemplo cURL

curl -X POST https://cosmic.ia.br/v1/embeddings \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer SUA_CHAVE_LOCAL" \
  -d '{
    "model": "bge-small-en-v1.5",
    "input": "Texto para gerar embedding"
  }'

Modelos de Embeddings

Modelo	Dimensões	Uso
bge-small-en-v1.5	384	Busca semântica rápida
bge-base-en-v1.5	768	Uso geral
bge-large-en-v1.5	1024	Alta precisão

POST/v1/translate

Tradução entre mais de 100 idiomas usando o modelo M2M100.

Ver exemplo cURL

curl -X POST https://cosmic.ia.br/v1/translate \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer SUA_CHAVE_LOCAL" \
  -d '{
    "text": "Inteligência artificial está mudando o mundo.",
    "source_lang": "portuguese",
    "target_lang": "english"
  }'

💬 Modelos de Texto

ID	Descrição	Tier
cosmic-v2	🧠 Nossa IA própria com cache semântico e aprendizado contínuo	✨ Cosmic
cosmic-fast / gpt-4.1-nano	Llama 3.2 1B — ultra rápido, baixo custo	Rápido
cosmic-balanced / gpt-4.1-mini / gpt-4o-mini	Llama 3.1 8B — equilibrado	Equilibrado
cosmic-pro / gpt-4o / gpt-4.1 / gemini-2.5-flash	Llama 3.3 70B — excelente qualidade	Pro

🖼 Modelos de Imagem

ID	Resolução	Velocidade
flux-1-schnell	Até 1024x1024	Ultra rápido
dreamshaper-8-lcm	512x512	Rápido
stable-diffusion-xl-base-1.0	1024x1024	Médio

🎵 Modelos de Áudio

ID	Tipo	Idioma
aura-2-es	TTS	PT / ES
aura-2-en	TTS	EN
whisper	ASR	Multilingual

GET/v1/models

Retorna a lista completa de modelos disponíveis (requer autenticação).

🔑 Autenticação

Todas as requisições (exceto o playground de testes) requerem uma chave de API no header Authorization.

Authorization: Bearer SUA_CHAVE_LOCAL

Códigos de Status

Código	Significado
200	Sucesso
400	Requisição inválida (JSON malformado ou campo obrigatório ausente)
401	Chave de API ausente ou formato inválido
403	Chave de API inválida ou inativa
429	Limite de requisições atingido (trial: 5/IP/24h)
503	Serviço temporariamente indisponível

Base URL

https://cosmic.ia.br/v1

Alternativa (mesma API): https://llm-proxy.studiosplay.com/v1

Clientes OpenAI usam a URL-base acima; /v1/chat/completions requer POST e autenticação Bearer. Uma visita por GET retorna HTTP 405.

Compatível com clientes OpenAI — basta trocar a base URL e usar sua chave local.