Endpoints
Bilder
Generera och redigera bilder med POST /images/generations och alla bildmodeller i katalogen, med parametrar, svar, priser och felkoder.
Testa i playgroundGenerera och redigera bilder med alla bildmodeller i katalogen: GPT image, Gemini image, FLUX, Seedream, Recraft med flera. Endpointen använder OpenAI SDK:s sökväg, så client.images.generate(...) fungerar oförändrat.
POST https://api14.com/api/v1/images/generations
POST /api/v1/images accepteras som alias. Båda vidarebefordrar innehållet oförändrat.
Anrop
| Parameter | Typ | Obligatorisk | Beskrivning |
|---|---|---|---|
model | string | ja | Ett bildmodell-id, t.ex. openai/gpt-5.4-image-2. |
prompt | string | ja | Vad som ska ritas. |
n | integer | nej | Antal bilder. Varje bild faktureras. |
size | string | nej | t.ex. 1024x1024, 1536x1024. Vilka storlekar som stöds varierar mellan modeller. |
aspect_ratio | string | nej | t.ex. 16:9, 1:1, för modeller som tar proportioner i stället för storlekar. |
quality | string | nej | t.ex. low, medium, high där det stöds. |
response_format | string | nej | b64_json eller url där det stöds. |
image | string eller string[] | nej | Referensbild(er) som URL:er eller data:-URI:er för redigering / bild-till-bild. |
Modellspecifika alternativ (upplösningar, bildproportioner) listas per modell i GET /images/models och på varje modellsida.
Exempel
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api14.com/api/v1",
apiKey: process.env.API14_API_KEY,
});
const result = await client.images.generate({
"model": "openai/gpt-5.4-image-2",
"prompt": "A minimalist product photo of a ceramic mug on a wooden table",
"n": 1,
"aspect_ratio": "1:1"
});
import { writeFile } from "node:fs/promises";
await writeFile("image.png", Buffer.from(result.data[0].b64_json, "base64"));
Svar
{
"created": 1791100000,
"data": [
{ "b64_json": "iVBORw0KGgoAAAANSUhEUgAA..." }
],
"usage": { "cost": 0.04 }
}
Vissa modeller returnerar url i stället för b64_json. Ladda ner hostade URL:er direkt, eftersom de kan gå ut.
Bilder via chat
Bildmodeller som även ger text som utdata kan anropas via Chat completions med modalities:
{
"model": "google/gemini-2.5-flash-image",
"modalities": ["image", "text"],
"messages": [{ "role": "user", "content": "A watercolor fox, square" }]
}
Genererade bilder kommer tillbaka i choices[0].message.images[] som data-URL:er.
Lista bildmodeller
# Public, no API key needed
curl https://api14.com/api/v1/images/models
curl "https://api14.com/api/v1/models?category=image"
Priser
Bildmodeller faktureras till sitt listade pris, per bild eller per 1M bildtokens, beroende på modell. Den exakta kostnaden hämtas från uppströmssvaret och dras från ditt USD-saldo.
Fel
| Status | Kod | När |
|---|---|---|
| 400 | model_required / invalid_json | model saknas eller så är innehållet felaktigt. |
| 402 | insufficient_balance | Ditt USD-saldo är 0 USD. |
| 403 | model_not_allowed / plan_required | Nyckelns tillåtelselista eller plan utesluter modellen. |
| 404 | model_not_found | Okänt eller inaktiverat modell-id. |
| 413 | payload_too_large | Innehållet (t.ex. inbäddade referensbilder) överskrider storleksgränsen. |
Valideringsfel uppströms (storlek som inte stöds, innehållspolicy) skickas vidare med sin status. Se Fel.