Mulai dengan JavaScript / TypeScript (SDK OpenAI)

seamless.ai.id kompatibel dengan API OpenAI. Yang berbeda hanya base URL dan API key:

https://16-79-198-229.sslip.io/v1

1. Siapkan API key

Pendaftaran mandiri belum dibuka: minta API key ke operator seamless.ai.id. Isi saldo dari dashboard (QRIS) sebelum memanggil model berbayar. Simpan key di variabel lingkungan, jangan di kode:

export SEAMLESS_API_KEY='sk-seamless-...'

2. Pasang SDK OpenAI

npm install openai

3. Panggilan pertama

Simpan sebagai halo.mjs lalu jalankan node halo.mjs (Node.js 18 ke atas). Kode yang sama berjalan sebagai TypeScript.

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://16-79-198-229.sslip.io/v1",
  apiKey: process.env.SEAMLESS_API_KEY,
});

const reply = await client.chat.completions.create({
  model: "qwen/qwen2.5-0.5b-instruct",
  messages: [{ role: "user", content: "Halo! Apa itu AI gateway?" }],
  max_tokens: 500,
});
console.log(reply.choices[0].message.content);

Streaming

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://16-79-198-229.sslip.io/v1",
  apiKey: process.env.SEAMLESS_API_KEY,
});

const stream = await client.chat.completions.create({
  model: "qwen/qwen2.5-0.5b-instruct",
  messages: [{ role: "user", content: "Ceritakan sejarah singkat Jakarta." }],
  stream: true,
});
for await (const chunk of stream) {
  process.stdout.write(chunk.choices[0]?.delta?.content ?? "");
}

Responses API

POST /v1/responses menerima format Responses API OpenAI untuk setiap model chat, dengan harga, saldo yang ditahan, dan tagihan yang sama dengan chat completions. Server tidak menyimpan jawaban: kirim percakapan lengkap di input setiap kali. Yang didukung dan yang ditolak ada di ringkasan.

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://16-79-198-229.sslip.io/v1",
  apiKey: process.env.SEAMLESS_API_KEY,
});

const response = await client.responses.create({
  model: "qwen/qwen2.5-0.5b-instruct",
  instructions: "Jawab singkat dalam bahasa Indonesia.",
  input: "Halo! Apa itu AI gateway?",
  max_output_tokens: 500,
  store: false,
});
console.log(response.output_text);

const stream = await client.responses.create({
  model: "qwen/qwen2.5-0.5b-instruct",
  input: "Ceritakan sejarah singkat Jakarta.",
  stream: true,
  store: false,
});
for await (const event of stream) {
  if (event.type === "response.output_text.delta") process.stdout.write(event.delta);
}

Input gambar

Saat ini tidak ada model di daftar harga yang menerima gambar; request bergambar ke model berbayar ditolak (400 unsupported_content).

Memilih provider

Field gateway ikut di body request; opsi lengkapnya di ringkasan.

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://16-79-198-229.sslip.io/v1",
  apiKey: process.env.SEAMLESS_API_KEY,
});

const reply = await client.chat.completions.create({
  model: "qwen/qwen2.5-0.5b-instruct",
  messages: [{ role: "user", content: "Halo!" }],
  // Field milik gateway, bukan bagian tipe OpenAI (TypeScript perlu baris berikut).
  // @ts-expect-error
  gateway: { routing: { order: ["default"] } },
});
console.log(reply.choices[0].message.content);

Kalau gagal

Error berformat OpenAI (error.type, error.code, error.param); daftar kode yang paling sering ada di ringkasan.