Começar

Guia rápido

Três passos: uma chave, duas definições, um pedido.

1. Criar uma conta e uma chave

Crie uma conta (sem palavra-passe: enviamos-lhe um código por email) e adicione crédito em Faturação.
Abra API Chaves de, dê um nome à chave e crie-a. Copie-a de imediato: a chave completa só é apresentada uma vez.

2. Definir a chave e o URL base

Não inclua a chave no código. Na shell, ou num ficheiro .env que a aplicação carregue:

.env

ZURELAY_API_KEY=zr_live_your_key_here

Depois, instale um SDK se ainda não tiver um: pip install openai para Python, npm install openai para Node. Os SDKs da Anthropic também funcionam (ver Anthropic Messages).

3. Enviar um pedido

main.py

import os
from openai import OpenAI
client = OpenAI(
    base_url="https://api.zurelay.com/v1",
    api_key=os.environ["ZURELAY_API_KEY"],
)
response = client.chat.completions.create(
    model="gpt-6-sol",
    messages=[
      {
        "role": "system",
        "content": "You are a concise assistant."
      },
      {
        "role": "user",
        "content": "Give me three names for a coffee shop on the moon."
      }
    ],
)
print(response.choices[0].message.content)

A resposta chega no formato da OpenAI, com o modelo que respondeu e os tokens utilizados:

Resposta

{
  "id": "chatcmpl-...",
  "object": "chat.completion",
  "created": 1790870400,
  "model": "gpt-6-sol",
  "choices": [
    {
      "index": 0,
      "message": { "role": "assistant", "content": "1. Lunar Grind\n2. ..." },
      "finish_reason": "stop"
    }
  ],
  "usage": { "prompt_tokens": 31, "completion_tokens": 24, "total_tokens": 55 }
}

Receber em streaming

Adicione stream: true para receber a resposta à medida que é escrita, tal como no streaming da OpenAI.

main.py

import os
from openai import OpenAI
client = OpenAI(
    base_url="https://api.zurelay.com/v1",
    api_key=os.environ["ZURELAY_API_KEY"],
)
stream = client.chat.completions.create(
    model="gemini-3.7-flash",
    messages=[
      {
        "role": "user",
        "content": "Write a haiku about latency."
      }
    ],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

Seguinte

Escolher um modeloIDs, preços e tipos de dados que cada modelo aceita.Enviar uma imagem ou um PDFOs ficheiros são incluídos na mensagem, como dados ou através de um link.Criar uma imagemUma chamada a /v1/images/generations.Usar as suas ferramentasClaude Code, Cursor, LangChain e muito mais.

Tem dúvidas ou falta alguma coisa? Contacte a nossa equipa de apoio e responderemos por email, normalmente num minuto.