نمونه‌های پیاده‌سازی

// Run on your server. Never send the project key to the browser.
export async function answerQuestion(question) {
  const response = await fetch("https://api.mahvashai.ir/v1/responses", {
    method: "POST",
    headers: {
      Authorization: "Bearer " + process.env.MAHVASH_API_KEY,
      "Content-Type": "application/json",
      "Idempotency-Key": crypto.randomUUID(),
    },
    body: JSON.stringify({ model: "auto", input: question }),
  });
  if (!response.ok) throw new Error("Mahvash HTTP " + response.status);
  const result = await response.json();
  return { id: result.id, output: result.output };
}

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.MAHVASH_API_KEY,
  baseURL: "https://api.mahvashai.ir/v1",
});

const response = await client.responses.create({
  model: "auto",
  input: "Say hello in one sentence.",
});
console.log(response.output_text);

curl https://api.mahvashai.ir/api/v1/chat/assets/upload \
  -H "Authorization: Bearer $MAHVASH_API_KEY" \
  -F 'file=@./brief.pdf'

# Keep the returned asset UUID in ASSET_ID, then use it in a supported request:
curl https://api.mahvashai.ir/v1/responses \
  -H "Authorization: Bearer $MAHVASH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"auto","input":"Summarize this file","asset_ids":["<asset-uuid>"]}'

const response = await fetch("https://api.mahvashai.ir/v1/responses", {
  method: "POST",
  headers: {
    Authorization: "Bearer " + process.env.MAHVASH_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ model: "auto", input: "Say hello", stream: true }),
});
if (!response.ok || !response.body) throw new Error("HTTP " + response.status);
const reader = response.body.getReader();
const decoder = new TextDecoder();
let pending = "";
let terminal = false;
while (!terminal) {
  const { value, done } = await reader.read();
  if (done) break;
  pending += decoder.decode(value, { stream: true });
  const frames = pending.split(/\r?\n\r?\n/);
  pending = frames.pop() ?? "";
  for (const frame of frames) {
    const data = frame.split(/\r?\n/).filter(line => line.startsWith("data:"))
      .map(line => line.slice(5).trim()).join("\n");
    if (!data || data === "[DONE]") continue;
    const event = JSON.parse(data);
    if (event.type === "response.output_text.delta") process.stdout.write(event.delta);
    if (["response.completed", "response.incomplete", "response.failed"].includes(event.type)) terminal = true;
  }
}
if (!terminal) throw new Error("Stream disconnected; inspect the response before retrying.");

curl https://api.mahvashai.ir/v1/responses \
  -H "Authorization: Bearer $MAHVASH_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: <unique-job-id>" \
  -d '{"model":"auto","input":"Summarize this document","background":true}'

# Save the returned response ID, then retrieve its current status:
curl https://api.mahvashai.ir/v1/responses/<response-id> \
  -H "Authorization: Bearer $MAHVASH_API_KEY"