Model APIs

Use the web app to choose inputs, inspect a result and decide which model belongs in your integration. The same model ids, request fields, jobs and assets are available through the API.

Try it on nolgia.ai #

Open a creation page, choose a model and enter your prompt. The creation pages and Library ask anonymous visitors to sign in.

For an API integration, start with the same model and prompt, then consult Common model arguments for the supported settings. A model name alone does not guarantee support for every size, duration or reference type.

What the web app shows #

The app shows the price before the run, the job's status while it runs, and the asset when it finishes. The price comes from the same POST /jobs/cost quote and confirmation token you can use from the API.

enhanced_prompt is an image field. It is absent or null when your words ran unchanged, on video or audio, and on older assets that predate the field; its absence does not mean the job failed.

The same job underneath #

Model generations made in the app are jobs and assets the API can return in the same account or organization context. Read GET /jobs/{id} for the generation and GET /assets/{id} for the file; there is no separate web-only result to export before an integration can use it.

These fields explain where a generation came from; they do not change how you wait for its result. See Platform headers for surface attribution and Agent Sessions API for collecting a conversation's media.

Comparing and sharing #

Quote the same inputs on several models before choosing. Each call to POST /jobs/cost validates the requested settings and returns their exact credit cost without creating a job or reserving credits.

$ curl --fail-with-body -sS https://api.nolgia.ai/v1/jobs/cost \
  -H "Authorization: Bearer $NOLGIA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"kind":"image","image":{"model":"flux-pro","prompt":"a paper-cut mountain range at dawn"}}'
$ curl --fail-with-body -sS https://api.nolgia.ai/v1/jobs/cost \
  -H "Authorization: Bearer $NOLGIA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"kind":"image","image":{"model":"gpt-image-2","prompt":"a paper-cut mountain range at dawn"}}'

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

const nolgia = createNolgiaClient(process.env.NOLGIA_TOKEN!);
for (const model of ["flux-pro", "gpt-image-2"] as const) {
  const { data: quote, error } = await nolgia.POST("/jobs/cost", {
    body: { kind: "image", image: { model, prompt: "a paper-cut mountain range at dawn" } },
  });
  if (error) throw new Error(`${error.title}: ${error.detail ?? ""}`);
  console.log(quote);
}

import os
from nolgia import AuthenticatedClient
from nolgia.api.jobs import quote_job_cost
from nolgia.models import GenerateImageRequest, ImageModel, JobCostKind, JobCostQuote, JobCostRequest

client = AuthenticatedClient(base_url="https://api.nolgia.ai/v1", token=os.environ["NOLGIA_TOKEN"])
for model in ("flux-pro", "gpt-image-2"):
    quote = quote_job_cost.sync(client=client, body=JobCostRequest(
        kind=JobCostKind("image"),
        image=GenerateImageRequest(model=ImageModel(model), prompt="a paper-cut mountain range at dawn"),
    ))
    if not isinstance(quote, JobCostQuote):
        raise SystemExit(f"refused: {quote}")
    print(quote.to_dict())

This captured flux-pro quote shows the response shape; the confirmation token is redacted. Run the calls above for current prices and fresh tokens rather than reusing the captured quote.

{
  "balance_credits": 2573,
  "basis": "one_generation",
  "confirmation_token": "…",
  "credits": 4,
  "expires_at": "2026-09-21T03:43:14.171728407Z",
  "kind": "image",
  "model": "flux-pro",
  "settings": [
    {
      "label": "Model",
      "value": "flux-pro"
    }
  ],
  "sufficient_credits": true
}

Parameters #

Set kind and the matching request object. Keep that object unchanged when you send its confirmation token to the generation endpoint; changing the model or settings requires another quote.

Error responses #

Once you have a result worth sharing, create a share link instead of sending its expiring download URL. File access controls covers share-link creation and revocation in the API reference.

There is no side-by-side compare view and no "copy this form as code" button; the Quick Start tabs are the code.

Next steps #