Início rápido

Uma chave, um pedido, uma resposta. Cinco minutos se já tiveres Python ou Node.js.

Nesta página

Três passos
Ler a resposta
A seguir

Três passos

Obter uma chave

As chaves de API estão disponíveis para os espaços de trabalho Team e para os parceiros. Escreve-nos, criamos a chave contigo e só a recebes uma vez.
Tudo sobre as chaves
Mantê-la fora do código

Coloca-a numa variável de ambiente do teu servidor. Os exemplos desta documentação leem-na daí.
Shell
```
export LEARNYA_API_KEY="lya_svc_…"
```

Enviar o pedido

Com o SDK OpenAI ou um simples pedido HTTP. Os valores a âmbar são os que adaptas.

curl https://api.learnya.ai/v1/chat/completions \
  -H "Authorization: Bearer $LEARNYA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "flash",
    "messages": [
      {
        "role": "user",
        "content": "Summarise Swiss data protection law."
      }
    ]
  }'

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.learnya.ai/v1",
    api_key=os.environ["LEARNYA_API_KEY"],
)

response = client.chat.completions.create(
    model="flash",
    messages=[
        {
            "role": "user",
            "content": "Summarise Swiss data protection law.",
        }
    ],
)
print(response.choices[0].message.content)

import OpenAI from "openai"

const client = new OpenAI({
  baseURL: "https://api.learnya.ai/v1",
  apiKey: process.env.LEARNYA_API_KEY,
})

const response = await client.chat.completions.create({
  model: "flash",
  messages: [
    {
      role: "user",
      content: "Summarise Swiss data protection law.",
    },
  ],
})
console.log(response.choices[0].message.content)

import OpenAI from "openai"

const client = new OpenAI({
  baseURL: "https://api.learnya.ai/v1",
  apiKey: process.env.LEARNYA_API_KEY,
})

const response: OpenAI.ChatCompletion =
  await client.chat.completions.create({
    model: "flash",
    messages: [
      {
        role: "user",
        content: "Summarise Swiss data protection law.",
      },
    ],
  })
const answer: string | null =
  response.choices[0].message.content
console.log(answer)

Resposta

{
  "id": "chatcmpl-5d0c9e2a41b7",
  "object": "chat.completion",
  "created": 1791633600,
  "model": "learnya-flash",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "1. Personal data is processed lawfully, in good faith and for a stated purpose.\n2. Data protection is built in by design and by default.\n3. People can access their data and have it corrected or deleted."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": { "prompt_tokens": 21, "completion_tokens": 52, "total_tokens": 73 }
}

Ler a resposta

O texto da resposta está na primeira escolha, na sua mensagem, no seu conteúdo. A contagem de tokens está no campo usage.

Onde	O que encontras
`choices[0].message.content`	O texto da resposta
`choices[0].finish_reason`	Porque é que o modelo parou: fim natural ou limite de comprimento atingido
`usage`	Os tokens lidos e escritos pelo modelo
`x-learnya-slot`	Cabeçalho de resposta: o modelo Learnya que respondeu

A seguir

GuiaConversaInstruções, conversas com várias interações e raciocínio.GuiaRespostas em fluxoMostrar a resposta enquanto é escrita.GuiaFerramentasDeixar o modelo chamar as tuas funções.

Três passos

Obter uma chave

Mantê-la fora do código

Enviar o pedido

Ler a resposta

A seguir