Model APIs

Price a generation before submitting it, show the customer that price, and follow its hold through to a charge or refund. Published model prices, quotes and the itemized ledger all use credits.

Per-model pricing #

Each model publishes its billing unit. Read the current catalog rather than keeping a second price list in your application.

See Model APIs for the full per-model tables. A missing cost means the price is not published; display an unknown price, not zero. Nolgia does not expose a GPU-time billing fallback.

What you pay for #

Generations #

Nolgia takes a credit hold when the request is accepted. Delivery consumes that hold; it does not create a second charge. A failed job normally releases the hold, subject to the policy-refusal exception below.

Agent turns and Studio renders #

What you are not charged for #

Checking prices programmatically #

Published model prices #

$ curl --fail-with-body -sS https://api.nolgia.ai/v1/pricing/models

This trimmed flux-pro entry preserves the real cost and quality values from the production model fixture. The public response wraps entries in models; other models and other pricing fields are omitted here.

{
  "models": [
    {
      "id": "flux-pro",
      "modality": "image",
      "min_tier": "starter",
      "cost": { "credits": 4, "unit": "per_image" },
      "quality": {
        "default": "native",
        "options": [
          { "credits": 4, "id": "native", "premium": false },
          { "credits": 17, "id": "2k", "premium": true },
          { "credits": 54, "id": "4k", "premium": true }
        ]
      }
    }
  ]
}

Quote the exact request #

These examples use the generated clients. The CLI currently has no dedicated quote command; its tab uses curl with the same NOLGIA_TOKEN. The response below is a production capture, not a claim that each language example was run live.

$ 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"}}'

$ # No dedicated nolgia quote command; call the quote endpoint directly.
$ 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"}}'

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

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

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"])
quote = quote_job_cost.sync(client=client, body=JobCostRequest(
    kind=JobCostKind("image"),
    image=GenerateImageRequest(model=ImageModel("flux-pro"), prompt="a paper-cut mountain range at dawn"),
))
if not isinstance(quote, JobCostQuote):
    raise SystemExit(f"refused: {quote}")
print(quote.credits_, quote.expires_at)

use nolgia_client::{types, ClientBuilder};

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = ClientBuilder::new("https://api.nolgia.ai/v1")
        .bearer_token(std::env::var("NOLGIA_TOKEN")?)
        .build()?;
    let prompt: types::GenerateImageRequestPrompt = "a paper-cut mountain range at dawn".parse()?;
    let image: types::GenerateImageRequest = types::GenerateImageRequest::builder()
        .model("flux-pro").prompt(Some(prompt)).num_images(1u64).try_into()?;
    let quote = client.quote_job_cost()
        .body_map(|b| b.kind(types::JobCostKind::Image).image(Some(image)))
        .send().await?.into_inner();
    println!("{} {}", quote.credits, quote.expires_at);
    Ok(())
}

The real cost-image.json capture quotes one native flux-pro image. Its prompt differs from the reusable example above, and its opaque confirmation token is redacted.

{
  "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
}

Return confirmation_token on the unchanged generation body if you want submission bound to the quoted request and price. The token is optional; when supplied, a stale, malformed, foreign or mismatched token fails with 422 confirmation_rejected. Quote again. sufficient_credits is advisory because submission checks the balance again.

Balances and the ledger #

Spendable balances #

Personal Access Tokens you create spend available_for_api. The app, the Nolgia Agent, organization API keys and connected assistants (ChatGPT, Claude or any MCP client connected through OAuth) spend available_for_app. available_for_credential is the figure for the credential that made the request, and credential_channel names its channel. Monthly app_subscription credits expire at the subscription cycle end; shared_topup credits do not expire and are spendable by either surface.

$ curl --fail-with-body -sS https://api.nolgia.ai/v1/billing/credits \
  -H "Authorization: Bearer $NOLGIA_TOKEN"

This schema-built example shows a personal account with 100 subscription credits and 200 top-up credits.

{
  "user_id": "00000000-0000-4000-8000-000000000001",
  "scope": "personal",
  "app_subscription": 100,
  "shared_topup": 200,
  "total": 300,
  "available_for_app": 300,
  "available_for_api": 200,
  "buckets": [
    { "wallet_id": "00000000-0000-4000-8000-000000000002", "type": "app_subscription", "balance": 100, "expires_at": "2026-10-01T00:00:00Z" },
    { "wallet_id": "00000000-0000-4000-8000-000000000003", "type": "shared_topup", "balance": 200, "expires_at": null }
  ]
}

Itemized transactions #

GET /billing/transactions returns newest-first rows. The debit when a hold is taken is the charge; completion writes no second debit. Releasing it writes a refund for the same amount. balance_after belongs to the particular wallet_id, not to the combined account balance.

$ curl --fail-with-body -sS 'https://api.nolgia.ai/v1/billing/transactions?limit=20' \
  -H "Authorization: Bearer $NOLGIA_TOKEN"

This schema-built example uses the documented Quick Start amounts: a 12-credit veo-3.1-lite four-second charge and its 12-credit refund. The row ids, timestamps and wallet balances are illustrative; this is not a captured ledger response.

{
  "items": [
    {
      "id": "00000000-0000-4000-8000-000000000005",
      "occurred_at": "2026-09-21T03:36:00Z",
      "kind": "refund",
      "wallet": "topup",
      "wallet_id": "00000000-0000-4000-8000-000000000003",
      "credits": 12,
      "balance_after": 200,
      "description": "Refund · Video generation · veo-3.1-lite · 4 s",
      "model": "veo-3.1-lite",
      "job_id": "00000000-0000-4000-8000-000000000006"
    },
    {
      "id": "00000000-0000-4000-8000-000000000004",
      "occurred_at": "2026-09-21T03:35:00Z",
      "kind": "generation",
      "wallet": "topup",
      "wallet_id": "00000000-0000-4000-8000-000000000003",
      "credits": -12,
      "balance_after": 188,
      "description": "Video generation · veo-3.1-lite · 4 s",
      "model": "veo-3.1-lite",
      "job_id": "00000000-0000-4000-8000-000000000006"
    }
  ],
  "next_cursor": null,
  "scope": "personal"
}

Usage totals #

GET /billing/transactions/summary rolls up the same rows and scope. It defaults to the current UTC month; credits_used and credits_refunded are positive totals, while by_kind[].credits is signed.

$ curl --fail-with-body -sS https://api.nolgia.ai/v1/billing/transactions/summary \
  -H "Authorization: Bearer $NOLGIA_TOKEN"

This schema-built response illustrates the charge and refund above, with no other movements in the month.

{
  "from": "2026-09-01T00:00:00Z",
  "to": "2026-10-01T00:00:00Z",
  "scope": "personal",
  "credits_used": 12,
  "credits_refunded": 12,
  "credits_added": 0,
  "by_day": [ { "date": "2026-09-21", "credits_used": 12, "credits_refunded": 12 } ],
  "by_kind": [
    { "kind": "generation", "credits": -12, "count": 1 },
    { "kind": "refund", "credits": 12, "count": 1 }
  ]
}

Plans, top-ups and codes #

See nolgia.ai/pricing for current plans and credit purchases. Subscriptions supply monthly app credits; top-ups supply shared prepaid credits. A model's min_tier and its credit price are separate: adding credits does not unlock an out-of-plan model.

A code refusal returns 404 for an unknown code, 410 for a deactivated, expired or exhausted code, 409 if this account already redeemed it, and 429 for rate-limited attempts. A repeated redemption can never grant credits twice.

Organizations #

In an organization, spending uses the organization's wallets, not your personal balance. GET /organizations/{id}/credits reports the shared pool, seats, and monthly member budgets. An unlimited budget is null; the member's month-to-date spend includes both held and consumed reservations.

GET /organizations/{id}/usage groups consumed credits by member, model or UTC day; it defaults to the current UTC calendar month and excludes held and released reservations. Usage and activity explains why these totals differ from gross ledger charges. For organization contracts, see the Enterprise option on Pricing.