Endpoints
इमेज
POST /images/generations से टेक्स्ट से इमेज बनाएँ और इमेज एडिट करें। पैरामीटर, प्रतिक्रिया, चैट के ज़रिए इमेज, कीमत और त्रुटियाँ यहाँ हैं।
playground में आज़माएंकैटलॉग के हर इमेज मॉडल से इमेज बनाएँ और एडिट करें: GPT image, Gemini image, FLUX, Seedream, Recraft और अन्य। एंडपॉइंट OpenAI SDK का पाथ इस्तेमाल करता है, इसलिए client.images.generate(...) बिना बदलाव के काम करता है।
POST https://api14.com/api/v1/images/generations
POST /api/v1/images उपनाम के रूप में स्वीकार होता है। दोनों बॉडी को बिना बदले आगे भेजते हैं।
अनुरोध
| पैरामीटर | प्रकार | आवश्यक | विवरण |
|---|---|---|---|
model | string | हाँ | इमेज मॉडल id, जैसे openai/gpt-5.4-image-2। |
prompt | string | हाँ | क्या बनाना है। |
n | integer | नहीं | इमेज की संख्या। हर इमेज का बिल बनता है। |
size | string | नहीं | जैसे 1024x1024, 1536x1024। समर्थित आकार मॉडल के अनुसार बदलते हैं। |
aspect_ratio | string | नहीं | जैसे 16:9, 1:1, उन मॉडल के लिए जो आकार के बजाय अनुपात लेते हैं। |
quality | string | नहीं | जैसे low, medium, high, जहाँ समर्थित हो। |
response_format | string | नहीं | b64_json या url, जहाँ समर्थित हो। |
image | string या string[] | नहीं | एडिटिंग / image-to-image के लिए संदर्भ इमेज, URL या data: URI के रूप में। |
मॉडल-विशिष्ट विकल्प (रेज़ोल्यूशन, आस्पेक्ट रेशियो) GET /images/models में और हर मॉडल पेज पर सूचीबद्ध हैं।
उदाहरण
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"));
प्रतिक्रिया
{
"created": 1791100000,
"data": [
{ "b64_json": "iVBORw0KGgoAAAANSUhEUgAA..." }
],
"usage": { "cost": 0.04 }
}
कुछ मॉडल b64_json के बजाय url लौटाते हैं। होस्ट किए गए URL जल्दी डाउनलोड करें; वे समाप्त हो सकते हैं।
चैट के ज़रिए इमेज
जो इमेज मॉडल टेक्स्ट भी आउटपुट करते हैं उन्हें modalities के साथ चैट कंप्लीशन्स से कॉल किया जा सकता है:
{
"model": "google/gemini-2.5-flash-image",
"modalities": ["image", "text"],
"messages": [{ "role": "user", "content": "A watercolor fox, square" }]
}
बनाई गई इमेज choices[0].message.images[] में data URL के रूप में आती हैं।
इमेज मॉडल सूचीबद्ध करना
# सार्वजनिक, API कुंजी की ज़रूरत नहीं
curl https://api14.com/api/v1/images/models
curl "https://api14.com/api/v1/models?category=image"
कीमत
इमेज मॉडल का बिल उनकी सूचीबद्ध कीमत पर बनता है, मॉडल के अनुसार प्रति इमेज या प्रति 1M इमेज टोकन। सटीक लागत अपस्ट्रीम प्रतिक्रिया से ली जाती है और आपके USD बैलेंस से कटती है।
त्रुटियाँ
| स्टेटस | कोड | कब |
|---|---|---|
| 400 | model_required / invalid_json | model गायब या बॉडी गलत रूप में। |
| 402 | insufficient_balance | आपका USD बैलेंस $0 है। |
| 403 | model_not_allowed / plan_required | कुंजी की allowlist या प्लान में मॉडल शामिल नहीं। |
| 404 | model_not_found | अज्ञात या अक्षम मॉडल id। |
| 413 | payload_too_large | बॉडी (जैसे इनलाइन संदर्भ इमेज) आकार सीमा से अधिक। |
अपस्ट्रीम validation त्रुटियाँ (असमर्थित आकार, कंटेंट नीति) अपने स्टेटस के साथ आगे पास की जाती हैं। देखें त्रुटियाँ।