API v1 · OpenAI-compatible

Integre a Orbit-Z em sites, aplicativos e automações

Autenticação Bearer e formato Chat Completions. A URL acompanha automaticamente a configuração do administrador.

URL base
https://api.orbit-z.shop/v1
Modelo
orbit-z
Chave
oz_live_SUA_CHAVE
Catálogo ativo

Modelos disponíveis

Escolha um dos IDs públicos abaixo no campo model. A lista acompanha automaticamente os modelos ativados pelo administrador, sem revelar provedor, URL ou nome interno.

ID para a APINome exibidoStatus
orbit-z-medioOrbit-Z-medioDisponível
orbit-zOrbit-ZDisponível
orbit-z-proOrbit-Z-PRODisponível
orbit-z-leveorbit-z-leveDisponível
{
  "model": "orbit-z-medio",
  "messages": [
    {"role": "user", "content": "Olá"}
  ]
}

Também é possível consultar esta lista com GET /v1/models usando sua chave.

Configuração universal

Aplicativos externos

Quando o aplicativo oferecer Custom OpenAI, OpenAI Compatible, Custom Provider ou Base URL, preencha:

CampoValor
ProviderOpenAI-compatible / Custom OpenAI
Base URLhttps://api.orbit-z.shop/v1
API keyoz_live_SUA_CHAVE
Modelorbit-z

Use em OpenWebUI, LibreChat, AnythingLLM, Dify, Flowise, n8n e clientes baseados no SDK da OpenAI que aceitem URL personalizada. Se o aplicativo acrescentar /v1 automaticamente, informe apenas https://api.orbit-z.shop.

OpenRouter e Claude/Anthropic: possuem protocolos próprios. Para chamar a Orbit-Z, escolha “Custom OpenAI/OpenAI-compatible”. Aplicativos presos exclusivamente ao endpoint nativo da Anthropic não conectam diretamente.
Código pronto

Exemplos por ambiente

CURL

curl https://api.orbit-z.shop/v1/chat/completions \
  -H "Authorization: Bearer oz_live_SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{"model":"orbit-z","messages":[{"role":"user","content":"Olá"}]}'

POWERSHELL

(Invoke-RestMethod -Uri 'https://api.orbit-z.shop/v1/chat/completions' -Method POST -Headers @{Authorization='Bearer oz_live_SUA_CHAVE'} -ContentType 'application/json; charset=utf-8' -Body (@{model='orbit-z';messages=@(@{role='user';content='Olá'})} | ConvertTo-Json -Depth 5)).choices[0].message.content

PHP

<?php
$ch=curl_init('https://api.orbit-z.shop/v1/chat/completions');
curl_setopt_array($ch,[CURLOPT_POST=>true,CURLOPT_RETURNTRANSFER=>true,CURLOPT_HTTPHEADER=>['Authorization: Bearer oz_live_SUA_CHAVE','Content-Type: application/json'],CURLOPT_POSTFIELDS=>json_encode(['model'=>'orbit-z','messages'=>[['role'=>'user','content'=>'Olá']]])]);
$data=json_decode(curl_exec($ch),true); echo $data['choices'][0]['message']['content'];

PYTHON

import requests
r=requests.post('https://api.orbit-z.shop/v1/chat/completions',headers={'Authorization':'Bearer oz_live_SUA_CHAVE'},json={'model':'orbit-z','messages':[{'role':'user','content':'Olá'}]})
r.raise_for_status()
print(r.json()['choices'][0]['message']['content'])

OPENAI PYTHON

from openai import OpenAI
client=OpenAI(api_key='oz_live_SUA_CHAVE',base_url='https://api.orbit-z.shop/v1')
r=client.chat.completions.create(model='orbit-z',messages=[{'role':'user','content':'Olá'}])
print(r.choices[0].message.content)

NODE

const r=await fetch('https://api.orbit-z.shop/v1/chat/completions',{method:'POST',headers:{Authorization:'Bearer oz_live_SUA_CHAVE','Content-Type':'application/json'},body:JSON.stringify({model:'orbit-z',messages:[{role:'user',content:'Olá'}]})});
const data=await r.json(); console.log(data.choices[0].message.content);

OPENAI NODE

import OpenAI from 'openai';
const client=new OpenAI({apiKey:'oz_live_SUA_CHAVE',baseURL:'https://api.orbit-z.shop/v1'});
const r=await client.chat.completions.create({model:'orbit-z',messages:[{role:'user',content:'Olá'}]});
console.log(r.choices[0].message.content);
Referência

Endpoints

MétodoEndpointUso
POST/v1/chat/completionsConversa
GET/v1/modelsModelos ativos
GET/v1/adaptersAdapters disponíveis
GET/v1/usageUso, limite e saldo

Erros usam HTTP e incluem error.code e request_id. Tokens e requisições obedecem ao plano ativo.

Sem backend próprio

Chatbot para qualquer site

No painel, personalize o widget e copie o código. O navegador recebe somente um identificador revogável; a chave real fica criptografada no servidor.

<script src="https://orbit-z.shop/assets/widget.js"
  data-orbit-widget="SEU_IDENTIFICADOR_PUBLICO" defer></script>

Plano de teste: exibe “by ❤️ Orbit-Z”. Plano pago ativo: remove a marca automaticamente.

Boas práticas

Proteja sua chave

  • Nunca coloque oz_live_... em JavaScript público
  • Use backend, variável de ambiente ou cofre de segredos
  • Crie uma chave diferente por site ou automação
  • Revogue imediatamente qualquer chave exposta
  • Configure origens permitidas no widget