SDK Node.js

npm install openai

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.uttapen.ir/v1",
  apiKey: process.env.UTTAPEN_API_KEY, // sk-up-...
});

const resp = await client.chat.completions.create({
  model: "openai/gpt-5-mini",
  messages: [
    { role: "system", content: "پاسخ کوتاه و فارسی بده." },
    { role: "user", content: "تفاوت map و forEach در JavaScript؟" },
  ],
  max_tokens: 300,
});
console.log(resp.choices[0].message.content);
console.log(resp.usage?.prompt_tokens, resp.usage?.completion_tokens);

const { data, response } = await client.chat.completions
  .create({ model: "openai/gpt-5-mini", messages: [{ role: "user", content: "سلام" }] })
  .withResponse();
console.log(response.headers.get("x-uttapen-cost-toman"), response.headers.get("x-uttapen-balance-toman"));
console.log(data.choices[0].message.content);

const controller = new AbortController();

const stream = await client.chat.completions.create(
  {
    model: "openai/gpt-5-mini",
    messages: [{ role: "user", content: "یک تابع اعتبارسنجی شماره موبایل ایران بنویس." }],
    stream: true,
  },
  { headers: { "X-Uttapen-Include-Meta": "1" }, signal: controller.signal },
);

for await (const chunk of stream) {
  if (chunk.object === "uttapen.meta") {
    console.log(`\n[هزینه: ${(chunk as any).cost_toman} تومان]`);
    continue;
  }
  process.stdout.write(chunk.choices[0]?.delta?.content ?? "");
}

const tools: OpenAI.Chat.ChatCompletionTool[] = [{
  type: "function",
  function: {
    name: "get_weather",
    description: "دمای فعلی یک شهر",
    parameters: { type: "object", properties: { city: { type: "string" } }, required: ["city"] },
  },
}];

const messages: OpenAI.Chat.ChatCompletionMessageParam[] = [{ role: "user", content: "هوای تهران؟" }];
const r1 = await client.chat.completions.create({ model: "openai/gpt-5-mini", messages, tools });
const msg = r1.choices[0].message;
messages.push(msg);
for (const call of msg.tool_calls ?? []) {
  if (call.type !== "function") continue;
  const args = JSON.parse(call.function.arguments);
  messages.push({ role: "tool", tool_call_id: call.id, content: JSON.stringify({ city: args.city, temp_c: 31 }) });
}
const r2 = await client.chat.completions.create({ model: "openai/gpt-5-mini", messages, tools });
console.log(r2.choices[0].message.content);

const emb = await client.embeddings.create({
  model: "openai/text-embedding-3-small",
  input: ["قرارداد اجاره", "اجاره‌نامهٔ ملک مسکونی"],
});
console.log(emb.data.length, emb.data[0].embedding.length, emb.usage.prompt_tokens);

import { z } from "zod";
import { zodResponseFormat } from "openai/helpers/zod";

const Ticket = z.object({ title: z.string(), priority: z.enum(["low", "medium", "high"]) });
const parsed = await client.chat.completions.parse({
  model: "openai/gpt-5-mini",
  messages: [{ role: "user", content: "سایت از دیشب بالا نمی‌آید، مشتری‌ها شاکی‌اند." }],
  response_format: zodResponseFormat(Ticket, "ticket"),
});
console.log(parsed.choices[0].message.parsed);

try {
  await client.chat.completions.create({ model: "openai/gpt-5-mini", messages });
} catch (err) {
  if (err instanceof OpenAI.AuthenticationError) {
    console.error("کلید uttapen نامعتبر است");
  } else if (err instanceof OpenAI.RateLimitError) {
    const wait = Number(err.headers?.get("retry-after") ?? 5);
    await new Promise((r) => setTimeout(r, wait * 1000));
  } else if (err instanceof OpenAI.APIError) {
    if (err.status === 402) {
      const info = (err.error as any)?.uttapen;
      console.error("شارژ لازم:", info?.required_toman, "تومان", info?.topup_url);
    } else {
      console.error(err.status, err.code, err.message);
    }
  } else throw err;
}

await client.chat.completions.create({
  model: "deepseek/deepseek-r1",
  messages,
  reasoning: { effort: "low" },
  models: ["openai/o3-mini"],
} as any);

// lib/uttapen.ts
import OpenAI from "openai";

export const uttapen = new OpenAI({
  baseURL: "https://api.uttapen.ir/v1",
  apiKey: process.env.UTTAPEN_API_KEY,
  timeout: 120_000,
  maxRetries: 1,
});

type UttapenMeta = { object: "uttapen.meta"; cost_toman: string; balance_toman: string; hold_toman: string };

function isMeta(chunk: unknown): chunk is UttapenMeta {
  return typeof chunk === "object" && chunk !== null && (chunk as { object?: string }).object === "uttapen.meta";
}

for await (const chunk of stream) {
  if (isMeta(chunk)) { console.log(chunk.cost_toman); continue; }
  process.stdout.write(chunk.choices[0]?.delta?.content ?? "");
}