ابنِ على NOLGIA.

from nolgia import AuthenticatedClient
from nolgia.api.generate import generate_image
from nolgia.api.jobs import wait_for_job
from nolgia.models import GenerateImageRequest, ImageModel, Job

# Create a token at https://nolgia.ai/settings/api-tokens and pass it as a bearer.
client = AuthenticatedClient(base_url="https://api.nolgia.ai/v1", token="nol_...")

# POST /generate/image answers 202 with a job.
job = generate_image.sync(
    client=client,
    body=GenerateImageRequest(model=ImageModel.GPT_IMAGE_2, prompt="a red fox in the snow"),
)
if not isinstance(job, Job):
    raise SystemExit(f"refused: {job}")

# Long-poll GET /jobs/{id}/wait for the finished asset.
done = wait_for_job.sync(job.id, client=client, timeout_seconds=120)
if isinstance(done, Job) and done.status == "succeeded":
    print(done.asset.signed_url)

import { createNolgiaClient } from "@nolgia/sdk";

// Create a token at https://nolgia.ai/settings/api-tokens and pass it as a bearer.
const nolgia = createNolgiaClient("nol_...");

// POST /generate/image answers 202 with a job.
const { data: job, error } = await nolgia.POST("/generate/image", {
  body: { model: "gpt-image-2", prompt: "a red fox in the snow", num_images: 1 },
});
if (error) throw new Error(`${error.title}: ${error.detail ?? ""}`);

// Long-poll GET /jobs/{id}/wait for the finished asset.
const { data: done } = await nolgia.GET("/jobs/{id}/wait", {
  params: { path: { id: job.id }, query: { timeout_seconds: 120 } },
});
if (done?.status === "succeeded") console.log(done.asset?.signed_url);

use nolgia::tokio;

#[tokio::main]
async fn main() -> nolgia::Result<()> {
    // Create a token at https://nolgia.ai/settings/api-tokens and export it as NOLGIA_API_KEY.
    let nolgia = nolgia::Client::from_env()?;

    // POST /generate/image answers 202 with a job; subscribe long-polls
    // GET /jobs/{id}/wait for the finished asset.
    let done = nolgia.subscribe(nolgia::image("gpt-image-2", "a red fox in the snow")).await?;
    nolgia.download(done.url().expect("an image"), "fox.png").await?;
    Ok(())
}

# Authenticate once: device login in your browser.
$ nolgia auth login

# Generate an image from a prompt.
$ nolgia gen image \
  --prompt "a serene mountain lake at dawn" \
  --out lake.png