Szybki start

Jantaris daje ci jeden klucz API i jedno saldo prepaid do modeli czatu, obrazu, wideo i audio. Ta strona prowadzi od zera do pierwszej odpowiedzi czatu i pierwszego wygenerowanego obrazu.

Base URL dla wszystkich zapytań:

text

https://jantaris.com/v1

1. Konto i klucz

Załóż konto i doładuj saldo (minimum 40 zł, szczegóły w Rozliczeniach).
Otwórz panel, przejdź do kluczy API i utwórz nowy klucz.
Od razu skopiuj klucz. Ma postać sk-jt- i 32 znaki, a panel pokazuje go tylko raz.

Trzymaj klucz w zmiennej środowiskowej, a nie w kodzie:

bash

export JANTARIS_API_KEY="sk-jt-..."

powershell

$env:JANTARIS_API_KEY = "sk-jt-..."

Więcej o kluczach, nagłówkach i limitach wydatków: Uwierzytelnianie.

2. Zapytanie do czatu

/v1/chat/completions mówi formatem OpenAI, więc oficjalne SDK OpenAI działają po zmianie base URL.

bash

curl https://jantaris.com/v1/chat/completions \
  -H "Authorization: Bearer $JANTARIS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "messages": [{"role": "user", "content": "Napisz haiku o kalejdoskopie."}]
  }'

python

# pip install openai
import os
from openai import OpenAI

client = OpenAI(base_url="https://jantaris.com/v1", api_key=os.environ["JANTARIS_API_KEY"])

resp = client.chat.completions.create(
    model="claude-sonnet-5",
    messages=[{"role": "user", "content": "Napisz haiku o kalejdoskopie."}],
)
print(resp.choices[0].message.content)
print(resp.usage)

javascript

// npm install openai
import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://jantaris.com/v1",
  apiKey: process.env.JANTARIS_API_KEY,
});

const resp = await client.chat.completions.create({
  model: "claude-sonnet-5",
  messages: [{ role: "user", content: "Napisz haiku o kalejdoskopie." }],
});
console.log(resp.choices[0].message.content);

Model zmieniasz samym polem model, np. gpt-6-sol, gemini-3.8-flash albo deepseek-v4.1-flash. Pełny opis: Czat.

3. Obraz

Modele mediów (obraz, wideo, audio) działają jako zadania przez POST /v1/generate. Przy obrazach dopisz ?wait=60, a serwer przytrzyma połączenie, aż wynik będzie gotowy.

bash

curl "https://jantaris.com/v1/generate?wait=60" \
  -H "Authorization: Bearer $JANTARIS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2.5",
    "input": {"prompt": "Szklany kalejdoskop na drewnianym biurku, poranne światło", "aspect_ratio": "1024x1024"}
  }'

python

import os, requests

r = requests.post(
    "https://jantaris.com/v1/generate",
    params={"wait": 60},
    headers={"Authorization": f"Bearer {os.environ['JANTARIS_API_KEY']}"},
    json={
        "model": "gpt-image-2.5",
        "input": {"prompt": "Szklany kalejdoskop na drewnianym biurku, poranne światło", "aspect_ratio": "1024x1024"},
    },
    timeout=130,
)
task = r.json()
print(r.status_code, task["status"])
if task["status"] == "succeeded":
    print(task["output"][0]["url"], task["cost"])

javascript

const r = await fetch("https://jantaris.com/v1/generate?wait=60", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.JANTARIS_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "gpt-image-2.5",
    input: { prompt: "Szklany kalejdoskop na drewnianym biurku, poranne światło", aspect_ratio: "1024x1024" },
  }),
});
const task = await r.json();
console.log(r.status, task.status, task.output?.[0]?.url);

Jeśli zadanie skończy się w ciągu 60 sekund, dostajesz 200 ze status: "succeeded" i tablicą output. Jeśli nie, dostajesz 202 z bieżącym stanem i dalej odpytujesz zadanie albo czekasz na webhook. Linki do wyników są tymczasowe, więc pobierz pliki, które chcesz zachować.

Aktualna cena tego modelu: 0,254 zł za obraz. Nieudana generacja nic nie kosztuje.

4. Saldo

bash

curl https://jantaris.com/v1/balance -H "Authorization: Bearer $JANTARIS_API_KEY"

json

{ "balance": "49.60", "available": "46.50", "currency": "PLN", "low_balance": false }

available to saldo pomniejszone o środki zablokowane pod zadania, które jeszcze trwają.

Co dalej

Chcesz	Strona
Streaming i wywołania narzędzi	Czat
SDK Anthropic albo Claude Code	Anthropic Messages, Claude Code
Wideo i audio	Generowanie
Identyfikatory modeli, ceny, parametry	Modele
Obsługa błędów	Błędy
n8n, Make, Zapier	No-code