curl --request POST \ --url https://api.friendli.ai/dedicated/v1/images/generations \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "model": "(endpoint-id)", "prompt": "An orange Lamborghini driving down a hill road at night with a beautiful ocean view in the background."}'
import requests
url = "https://api.friendli.ai/dedicated/v1/images/generations"
payload = {
"model": "(endpoint-id)",
"prompt": "An orange Lamborghini driving down a hill road at night with a beautiful ocean view in the background."
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)
const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
model: '(endpoint-id)',
prompt: 'An orange Lamborghini driving down a hill road at night with a beautiful ocean view in the background.'
})
};
fetch('https://api.friendli.ai/dedicated/v1/images/generations', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));
package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.friendli.ai/dedicated/v1/images/generations"
payload := strings.NewReader("{\n \"model\": \"(endpoint-id)\",\n \"prompt\": \"An orange Lamborghini driving down a hill road at night with a beautiful ocean view in the background.\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}
curl --request POST \ --url https://api.friendli.ai/dedicated/v1/images/generations \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "model": "(endpoint-id)", "prompt": "An orange Lamborghini driving down a hill road at night with a beautiful ocean view in the background."}'
import requests
url = "https://api.friendli.ai/dedicated/v1/images/generations"
payload = {
"model": "(endpoint-id)",
"prompt": "An orange Lamborghini driving down a hill road at night with a beautiful ocean view in the background."
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)
const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
model: '(endpoint-id)',
prompt: 'An orange Lamborghini driving down a hill road at night with a beautiful ocean view in the background.'
})
};
fetch('https://api.friendli.ai/dedicated/v1/images/generations', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));
package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.friendli.ai/dedicated/v1/images/generations"
payload := strings.NewReader("{\n \"model\": \"(endpoint-id)\",\n \"prompt\": \"An orange Lamborghini driving down a hill road at night with a beautiful ocean view in the background.\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}
Generate an image from a text prompt.To request successfully, it is mandatory to enter a Personal API Key (e.g. flp_XXX) value in the Bearer Token field.
Refer to the authentication section on our introduction page to learn how to acquire this variable and visit here to generate your API Key.
Authorizations
Authorization
string
header
required
When using Friendli Suite API, you need to provide a Personal API Key (e.g. flp_XXX) as a Bearer token for authentication and authorization purposes.
ID of team to run requests as (optional parameter).
Body
application/json
model
string
required
ID of target endpoint. If you want to send request to specific adapter, use the format "YOUR_ENDPOINT_ID:YOUR_ADAPTER_ROUTE". Otherwise, you can just use "YOUR_ENDPOINT_ID" alone.
Example:
"(endpoint-id)"
prompt
string
required
A text description of the desired image(s).
num_inference_steps
integer
default:20
The number of inference steps to use during image generation. Defaults to 20. Supported range: [1, 50].
guidance_scale
number | null
Adjusts the alignment of the generated image with the input prompt. Higher values (e.g., 8-10) make the output more faithful to the prompt, while lower values (e.g., 1-5) encourage more creative freedom. This parameter may be irrelevant for certain models, such as FLUX.Schnell.
seed
integer | null
The seed to use for image generation.
response_format
enum<string> | null
default:url
The format in which the generated image(s) will be returned. One of url(default), raw, png, jpeg, and jpg.
Available options:
url,
raw,
png,
jpeg,
jpg
control_images
ImageInput · object[] | null
Optional input images used to condition or guide the generation process (e.g., for ControlNet or image editing models). This field is only applicable when using ControlNet or image editing models.
Hide child attributes
control_images.image
string
required
An input image, provided either as a URL or a base64-encoded string. Maximum supported image size is 50 MiB.
A list of weights that determine the influence of each ControlNet model in the generation process. Each value must be within [0, 1], where 0 disables the corresponding ControlNet and 1 applies it fully. When multiple ControlNet models are used, the list length must match the number of control images. If omitted, all ControlNet models default to full influence (1.0). This field is only applicable when using ControlNet models.
Response
Successfully generated image(s).
data
UrlImageItem · object
required
UrlImageItem · object[]
B64ImageItem · object[]
Hide child attributes
data.seed
integer
required
The seed used during image generation.
data.response_format
enum<string>
required
The format of the generated image. One of url(default), raw, png, jpeg, and jpg.
Available options:
url,
raw,
png,
jpeg,
jpg
data.url
string
required
The URL of the generated image.
Last modified on June 9, 2026
Was this page helpful?
{"docsConfig":{"theme":"aspen","$schema":"https://mintlify.com/docs.json","name":"FriendliAI Docs","description":"Let your team focus on building great AI products. FriendliAI will make sure your AI runs fast, affordable, and reliable at scale. Leave the hassle of AI inference to FriendliAI.","colors":{"primary":"#2A62DB","light":"#4f87ff","dark":"#1e469b"},"logo":{"light":"https://mintcdn.com/friendliai/Xn-EfFlXFvptInk9/static/svgs/logo.svg?fit=max\u0026auto=format\u0026n=Xn-EfFlXFvptInk9\u0026q=85\u0026s=0a04a5dd2152a1258e6d3ce995b70eb0","dark":"https://mintcdn.com/friendliai/OmGyXdVnt91Gfn8z/static/svgs/logo-dark.svg?fit=max\u0026auto=format\u0026n=OmGyXdVnt91Gfn8z\u0026q=85\u0026s=7bc2b761b9c8da66973a9869b7de4f90"},"favicon":"https://mintcdn.com/friendliai/Xn-EfFlXFvptInk9/static/svgs/favicon.svg?fit=max\u0026auto=format\u0026n=Xn-EfFlXFvptInk9\u0026q=85\u0026s=d425e1903adeb917593a54eb3d20c66b","api":{"openapi":"https://github.com/friendliai/friendli-openapi/raw/refs/heads/main/openapi.yaml","params":{"expanded":"all"},"playground":{"display":"interactive"},"examples":{"defaults":"required","languages":["curl","python","javascript","go"],"prefill":true,"autogenerate":true}},"background":{"color":{"light":"#FFFFFF","dark":"#0A101A"}},"navbar":{"primary":{"type":"button","label":"Dashboard","href":"https://friendli.ai/get-started/dedicated-endpoints"}},"footer":{"socials":{"website":"https://friendli.ai","linkedin":"https://www.linkedin.com/company/friendliai","youtube":"https://www.youtube.com/@friendliai","github":"https://github.com/friendliai","discord":"https://discord.gg/g53ByexhR","x":"https://x.com/friendliai","medium":"https://medium.com/friendliai","facebook":"https://friendli.ai/?unused-social-placeholder-required-by-zod-4-hidden-by-css","slack":"https://friendli.ai/?unused-social-placeholder-required-by-zod-4-hidden-by-css","instagram":"https://friendli.ai/?unused-social-placeholder-required-by-zod-4-hidden-by-css","hacker-news":"https://friendli.ai/?unused-social-placeholder-required-by-zod-4-hidden-by-css","telegram":"https://friendli.ai/?unused-social-placeholder-required-by-zod-4-hidden-by-css","twitter":"https://friendli.ai/?unused-social-placeholder-required-by-zod-4-hidden-by-css","x-twitter":"https://friendli.ai/?unused-social-placeholder-required-by-zod-4-hidden-by-css","earth-americas":"https://friendli.ai/?unused-social-placeholder-required-by-zod-4-hidden-by-css","bluesky":"https://friendli.ai/?unused-social-placeholder-required-by-zod-4-hidden-by-css","threads":"https://friendli.ai/?unused-social-placeholder-required-by-zod-4-hidden-by-css","reddit":"https://friendli.ai/?unused-social-placeholder-required-by-zod-4-hidden-by-css","podcast":"https://friendli.ai/?unused-social-placeholder-required-by-zod-4-hidden-by-css"}},"search":{"prompt":"Search FriendliAI Docs..."},"seo":{"metatags":{"og:site_name":"FriendliAI Docs","twitter:card":"summary_large_image"}},"integrations":{"gtm":{"tagId":"GTM-MVXVF29V"},"telemetry":{"enabled":true}},"banner":{"content":"Try [GLM-5.3](https://friendli.ai/models/zai-org/GLM-5.3) and [GLM-5.3-Flash](https://friendli.ai/models/zai-org/GLM-5.3-Flash) today. To learn more, see the [FriendliAI Blog](https://friendli.ai/blog)."},"contextual":{"options":["copy","view","chatgpt","claude"],"display":"header"},"metadata":{"timestamp":true},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Home","icon":"home","href":"https://friendli.ai"},{"anchor":"Models","icon":"brain","href":"https://friendli.ai/models"},{"anchor":"Pricing","icon":"tag","href":"https://friendli.ai/pricing"},{"anchor":"Blog","icon":"newspaper","href":"https://friendli.ai/blog"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"friendliai","hasAudioNarration":false,"actualSubdomain":"friendliai","customDomains":["friendli.ai"],"gitSource":{"type":"github","owner":"friendliai","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true,"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6affa52095a415ad176e2a10","clientVersion":"0.0.4271","searchFilterCounts":[{"language":"default","tag":"Guides","count":45},{"language":"default","tag":"Examples","count":40},{"language":"default","tag":"Reference","count":36},{"language":"default","tag":"Inference","count":30},{"language":"default","tag":"Archive","count":24},{"language":"default","tag":"Dedicated","count":24},{"language":"default","tag":"Friendli Container","count":23},{"language":"default","tag":"Agents","count":14},{"language":"default","tag":"Friendli Dedicated Endpoints","count":12},{"language":"default","tag":"API Reference","count":12}]},"assistantConfig":{"enableStarterQuestions":true,"enableContextualStarterQuestions":true,"deflection":{"enabled":true,"email":"support@friendli.ai","showHelpButton":true}},"basePath":"/docs","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"/* cyrillic-ext */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/geistmono/v6/or3yQ6H-1_WfwkMZI_qYPLs1a-t7PU0AbeE9KK5Z5ClqOw.woff2) format('woff2');\n unicode-range: U+0460-052F, U+1C80-1C8A, U+20B4, U+2DE0-2DFF, U+A640-A69F, U+FE2E-FE2F;\n}\n/* cyrillic */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/geistmono/v6/or3yQ6H-1_WfwkMZI_qYPLs1a-t7PU0AbeE9KK5Q5ClqOw.woff2) format('woff2');\n unicode-range: U+0301, U+0400-045F, U+0490-0491, U+04B0-04B1, U+2116;\n}\n/* symbols2 */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/geistmono/v6/or3yQ6H-1_WfwkMZI_qYPLs1a-t7PU0AbeE9KK7uxQxXAuk.woff2) format('woff2');\n unicode-range: U+2000-2001, U+2004-2008, U+200A, U+23B8-23BD, U+2500-259F;\n}\n/* vietnamese */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/geistmono/v6/or3yQ6H-1_WfwkMZI_qYPLs1a-t7PU0AbeE9KK5b5ClqOw.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/geistmono/v6/or3yQ6H-1_WfwkMZI_qYPLs1a-t7PU0AbeE9KK5a5ClqOw.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/geistmono/v6/or3yQ6H-1_WfwkMZI_qYPLs1a-t7PU0AbeE9KK5U5Ck.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n@font-face{font-family:\"Saans-Light\";src:url(\"https://docs-assets.friendli.ai/fonts/Saans-Light.woff2\")\n\t\tformat(\"woff2\"),\n\t\turl(\"https://docs-assets.friendli.ai/fonts/Saans-Light.woff\") format(\"woff\");font-weight:300;font-style:normal;font-display:swap}@font-face{font-family:\"Saans-Regular\";src:url(\"https://docs-assets.friendli.ai/fonts/Saans-Regular.woff2\")\n\t\tformat(\"woff2\"),\n\t\turl(\"https://docs-assets.friendli.ai/fonts/Saans-Regular.woff\")\n\t\tformat(\"woff\");font-weight:400;font-style:normal;font-display:swap}@font-face{font-family:\"Saans-Medium\";src:url(\"https://docs-assets.friendli.ai/fonts/Saans-Medium.woff2\")\n\t\tformat(\"woff2\"),\n\t\turl(\"https://docs-assets.friendli.ai/fonts/Saans-Medium.woff\")\n\t\tformat(\"woff\");font-weight:500;font-style:normal;font-display:swap}@font-face{font-family:\"Saans-SemiBold\";src:url(\"https://docs-assets.friendli.ai/fonts/Saans-SemiBold.woff2\")\n\t\tformat(\"woff2\"),\n\t\turl(\"https://docs-assets.friendli.ai/fonts/Saans-SemiBold.woff\")\n\t\tformat(\"woff\");font-weight:600;font-style:normal;font-display:swap}@font-face{font-family:\"Saans-Bold\";src:url(\"https://docs-assets.friendli.ai/fonts/Saans-Bold.woff2\")\n\t\tformat(\"woff2\"),\n\t\turl(\"https://docs-assets.friendli.ai/fonts/Saans-Bold.woff\") format(\"woff\");font-weight:700;font-style:normal;font-display:swap}@font-face{font-family:\"Saans-Heavy\";src:url(\"https://docs-assets.friendli.ai/fonts/Saans-Heavy.woff2\")\n\t\tformat(\"woff2\"),\n\t\turl(\"https://docs-assets.friendli.ai/fonts/Saans-Heavy.woff\") format(\"woff\");font-weight:800;font-style:normal;font-display:swap}:root{--gray-300: 159 179 200;--primary-accent: #0095ff}.border-gray-100{border-color:#d9e2ec}body{font-family:\"Saans-Regular\", sans-serif;letter-spacing:0.01em}.tracking-tighter{letter-spacing:-0.04em}.tracking-tight{letter-spacing:0.01em}.tracking-normal{letter-spacing:0.01em}.tracking-wide{letter-spacing:0.01em}.tracking-wider{letter-spacing:0.05em}.tracking-widest{letter-spacing:0.1em}.prose :where(h1,h2,h3):not(:where([class~=\"not-prose\"],[class~=\"not-prose\"] *)){letter-spacing:0}.font-medium:not(.font-mono):not(.font-mono *),.mint-font-medium:not(.font-mono):not(.font-mono *){font-family:\"Saans-Medium\", sans-serif}h1:not(.font-mono):not(.font-mono *),h2:not(.font-mono):not(.font-mono *),h3:not(.font-mono):not(.font-mono *),h4:not(.font-mono):not(.font-mono *),h5:not(.font-mono):not(.font-mono *),strong:not(.font-mono):not(.font-mono *),.font-semibold:not(.font-mono):not(.font-mono *),.mint-font-semibold:not(.font-mono):not(.font-mono *),.prose :where(a):not(:where([class~=\"not-prose\"],[class~=\"not-prose\"] *)):not(.font-mono):not(.font-mono *){font-family:\"Saans-SemiBold\", sans-serif}.prose :is(p,li,td,dd) svg.icon{vertical-align:-0.025em!important}.prose :is(p,li,td,dd) a[href^=\"http\"]:not([href*=\"friendli.ai\"]):not(:has(img))::after{content:\"\";display:inline-block;width:0.7em;height:0.7em;margin-left:0.2em;vertical-align:-0.05em;background-color:currentColor;-webkit-mask:url(\"data:image/svg+xml,%3Csvg%20xmlns%3D%22http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg%22%20viewBox%3D%220%200%20512%20512%22%3E%3Cpath%20d%3D%22M320%200c-17.7%200-32%2014.3-32%2032s14.3%2032%2032%2032l82.7%200-201.4%20201.4c-12.5%2012.5-12.5%2032.8%200%2045.3s32.8%2012.5%2045.3%200L448%20109.3%20448%20192c0%2017.7%2014.3%2032%2032%2032s32-14.3%2032-32l0-160c0-17.7-14.3-32-32-32L320%200zM80%2096C35.8%2096%200%20131.8%200%20176L0%20432c0%2044.2%2035.8%2080%2080%2080l256%200c44.2%200%2080-35.8%2080-80l0-80c0-17.7-14.3-32-32-32s-32%2014.3-32%2032l0%2080c0%208.8-7.2%2016-16%2016L80%20448c-8.8%200-16-7.2-16-16l0-256c0-8.8%207.2-16%2016-16l80%200c17.7%200%2032-14.3%2032-32s-14.3-32-32-32L80%2096z%22%2F%3E%3C%2Fsvg%3E\")\n\t\tno-repeat center / contain;mask:url(\"data:image/svg+xml,%3Csvg%20xmlns%3D%22http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg%22%20viewBox%3D%220%200%20512%20512%22%3E%3Cpath%20d%3D%22M320%200c-17.7%200-32%2014.3-32%2032s14.3%2032%2032%2032l82.7%200-201.4%20201.4c-12.5%2012.5-12.5%2032.8%200%2045.3s32.8%2012.5%2045.3%200L448%20109.3%20448%20192c0%2017.7%2014.3%2032%2032%2032s32-14.3%2032-32l0-160c0-17.7-14.3-32-32-32L320%200zM80%2096C35.8%2096%200%20131.8%200%20176L0%20432c0%2044.2%2035.8%2080%2080%2080l256%200c44.2%200%2080-35.8%2080-80l0-80c0-17.7-14.3-32-32-32s-32%2014.3-32%2032l0%2080c0%208.8-7.2%2016-16%2016L80%20448c-8.8%200-16-7.2-16-16l0-256c0-8.8%207.2-16%2016-16l80%200c17.7%200%2032-14.3%2032-32s-14.3-32-32-32L80%2096z%22%2F%3E%3C%2Fsvg%3E\")\n\t\tno-repeat center / contain}code:not(.font-mono *),pre,kbd,.font-mono{font-family:\"Geist Mono\", ui-monospace, SFMono-Regular, Menlo, Monaco, monospace}#banner{background-color:var(--primary-accent);font-size:16px;box-shadow:none}#banner>div{margin-top:0.625rem;margin-bottom:0.625rem;p {\n\t\tcolor: #ffffff;\n\t}\n\n\ta {\n\t\tcolor: #ffffff;\n\t\tfont-weight: 600;\n\t\ttext-decoration: underline;\n\t\tpadding-left: 0.25rem;\n\t}}#topbar-cta-button,#topbar-cta-button a,#topbar-cta-button.bg-primary-dark,#topbar-cta-button .bg-primary-dark{background-color:#2a62db!important;color:#ffffff!important;border:none!important;border-radius:6px;box-shadow:none!important}#topbar-cta-button:hover,#topbar-cta-button:hover a,#topbar-cta-button:hover .bg-primary-dark,#topbar-cta-button a:hover,#topbar-cta-button a:hover .bg-primary-dark,#topbar-cta-button.bg-primary-dark:hover,#topbar-cta-button .bg-primary-dark:hover{background-color:#1a4ec4!important}#topbar-cta-button>.font-medium,#topbar-cta-button>.mint-font-medium{font-family:\"Saans-Medium\", sans-serif}#header>div:not(:first-child){display:none}.card>div>div:last-child>div{margin-top:0.5rem}.card [data-component-part=\"card-content\"]{font-family:\"Saans-Regular\", sans-serif}.card-group.columns{gap:1rem}.rounded-border-box{padding:28px 44px;border:1px solid #d9e2ec;border-radius:8px;overflow:hidden;img {\n\t\tmargin: 0 auto;\n\t\tborder: 1px solid #e7eef4;\n\t\tborder-radius: 8px;\n\t}\n\n\tp {\n\t\tmargin: 12px auto -12px;\n\t\ttext-align: center;\n\t\tword-break: break-all;\n\t}}.dark .rounded-border-box{border:1px solid #243b53}.dark .rounded-border-box img{border:1px solid #212832}html[data-current-path=\"/\"] .nav-tabs-item[data-active]{text-shadow:none}html[data-current-path=\"/\"] .nav-tabs-item[data-active]>div{display:none}html[data-current-path=\"/\"] #content-container{max-width:none;padding-inline:1rem}html[data-current-path=\"/\"] #header{display:none}html[data-current-path=\"/\"] #content{margin-top:0}#footer [href=\"https://friendli.ai/?unused-social-placeholder-required-by-zod-4-hidden-by-css\"]{display:none}"}]}
{"page":{"pagePath":"openapi/dedicated/inference/image-generations","slug":"/openapi/dedicated/inference/image-generations","pageMetadata":{"title":"Dedicated Image Generations","description":"Generate an image from a text prompt.","deprecated":null,"version":null,"sidebarTitle":"Image Generations","og:title":"Dedicated Image Generations","og:description":"Generate an image from a text prompt.","openapi":"https://github.com/friendliai/friendli-openapi/raw/refs/heads/main/openapi.yaml post /dedicated/v1/images/generations","href":"/openapi/dedicated/inference/image-generations","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Generate an image from a text prompt.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,p:`p`,strong:`strong`,..._provideComponents(),...props.components};return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Generate an image from a text prompt.`}),`\n`,_jsxs(_components.p,{children:[`To request successfully, it is mandatory to enter a `,_jsx(_components.strong,{children:`Personal API Key`}),` (e.g. flp_XXX) value in the `,_jsx(_components.strong,{children:`Bearer Token`}),` field.\nRefer to the `,_jsx(_components.a,{href:`/openapi/introduction#authentication`,children:`authentication section`}),` on our introduction page to learn how to acquire this variable and `,_jsx(_components.a,{href:`https://friendli.ai/suite/~/setting/keys`,children:`visit here`}),` to generate your API Key.`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Dedicated Image Generations","description":"Generate an image from a text prompt.","deprecated":null,"version":null,"sidebarTitle":"Image Generations","og:title":"Dedicated Image Generations","og:description":"Generate an image from a text prompt.","openapi":"https://github.com/friendliai/friendli-openapi/raw/refs/heads/main/openapi.yaml post /dedicated/v1/images/generations","href":"/openapi/dedicated/inference/image-generations","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/docs/_mintlify/custom/friendliai/13360a4393f88fc7/script.js"],"openApiReferenceData":{"operation":{"tags":["Dedicated.Image"],"summary":"Image generations","description":"Generate an image from a text prompt.","operationId":"dedicatedImagesGenerate","security":["46890439-ced6-4a43-9336-dc87718f9f99"],"parameters":["497e101c-e8a2-4b10-871c-7aebc762c563"],"requestBody":"b19bca9a-b393-42f9-b3ba-6bfb4a36a8b3","responses":{"200":"5dd82d9e-db23-4c3f-bb04-aa1272b91a50","422":"d774f344-2d69-474d-9a83-c03199a07618"},"x-speakeasy-name-override":"generate","x-mint":{"metadata":{"title":"Dedicated Image Generations","sidebarTitle":"Image Generations","og:title":"Dedicated Image Generations","description":"Generate an image from a text prompt.","og:description":"Generate an image from a text prompt."},"href":"/openapi/dedicated/inference/image-generations","content":"Generate an image from a text prompt.\n\nTo request successfully, it is mandatory to enter a **Personal API Key** (e.g. flp_XXX) value in the **Bearer Token** field.\nRefer to the [authentication section](/openapi/introduction#authentication) on our introduction page to learn how to acquire this variable and [visit here](https://friendli.ai/suite/~/setting/keys) to generate your API Key."},"method":"post","type":"path","servers":["6573dcb9-f1c7-4004-bf30-f967cb86a2a1"],"path":"/dedicated/v1/images/generations","baseUrlOptions":["https://api.friendli.ai"],"title":"Image generations","codeSamples":[],"requestExampleLanguages":["bash","python","javascript","go"],"requiredOnlyExamples":true,"requestExampleType":"generated","responseExampleType":"generated","prefillPlaygroundWithExample":true,"prefillPlaygroundExamples":[{"body.model":"(endpoint-id)","body.prompt":"An orange Lamborghini driving down a hill road at night with a beautiful ocean view in the background.","body.num_inference_steps":10}]},"dependencies":{"parameters":{"497e101c-e8a2-4b10-871c-7aebc762c563":{"name":"X-Friendli-Team","in":"header","required":false,"schema":{"description":"ID of team to run requests as (optional parameter).","title":"X-Friendli-Team","type":"string","isRequired":false,"uniqueKey":"","typeLabel":"string"},"description":"ID of team to run requests as (optional parameter)."}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"model":{"type":"string","title":"Model","description":"ID of target endpoint. If you want to send request to specific adapter, use the format \"YOUR_ENDPOINT_ID:YOUR_ADAPTER_ROUTE\". Otherwise, you can just use \"YOUR_ENDPOINT_ID\" alone.","examples":["(endpoint-id)"],"isRequired":true,"uniqueKey":"model","typeLabel":"string"},"prompt":{"type":"string","title":"Prompt","description":"A text description of the desired image(s).","isRequired":true,"uniqueKey":"prompt","typeLabel":"string"},"num_inference_steps":{"type":"integer","title":"Num Inference Steps","description":"The number of inference steps to use during image generation. Defaults to 20. Supported range: [1, 50].","default":20,"uniqueKey":"num_inference_steps","typeLabel":"integer"},"guidance_scale":{"oneOf":[{"type":"number","title":"Guidance Scale","description":"Adjusts the alignment of the generated image with the input prompt. Higher values (e.g., 8-10) make the output more faithful to the prompt, while lower values (e.g., 1-5) encourage more creative freedom. This parameter may be irrelevant for certain models, such as `FLUX.Schnell`.","uniqueKey":"guidance_scale.oneOf.0","typeLabel":"number"},{"type":"null","title":"Guidance Scale","description":"Adjusts the alignment of the generated image with the input prompt. Higher values (e.g., 8-10) make the output more faithful to the prompt, while lower values (e.g., 1-5) encourage more creative freedom. This parameter may be irrelevant for certain models, such as `FLUX.Schnell`.","uniqueKey":"guidance_scale.oneOf.1","typeLabel":"null"}],"uniqueKey":"guidance_scale","typeLabel":"number | null"},"seed":{"oneOf":[{"type":"integer","title":"Seed","description":"The seed to use for image generation.","uniqueKey":"seed.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Seed","description":"The seed to use for image generation.","uniqueKey":"seed.oneOf.1","typeLabel":"null"}],"uniqueKey":"seed","typeLabel":"integer | null"},"response_format":{"oneOf":[{"type":"string","title":"Response Format","description":"The format in which the generated image(s) will be returned. One of `url(default)`, `raw`, `png`, `jpeg`, and `jpg`.","default":"url","enum":["url","raw","png","jpeg","jpg"],"uniqueKey":"response_format.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","title":"Response Format","description":"The format in which the generated image(s) will be returned. One of `url(default)`, `raw`, `png`, `jpeg`, and `jpg`.","default":"url","uniqueKey":"response_format.oneOf.1","typeLabel":"null"}],"uniqueKey":"response_format","typeLabel":"enum\u003cstring> | null"},"control_images":{"oneOf":[{"type":"array","items":{"properties":{"image":{"type":"string","title":"Image","description":"An input image, provided either as a URL or a base64-encoded string. Maximum supported image size is 50 MiB.","examples":["https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/diffusers/cat.png","data:image/png;base64,..."],"isRequired":true,"uniqueKey":"control_images.oneOf.0.items.[INDEX].image","typeLabel":"string"}},"type":"object","required":["image"],"title":"ImageInput","uniqueKey":"control_images.oneOf.0.items.[INDEX]","typeLabel":"ImageInput · object"},"title":"Control Images","description":"Optional input images used to condition or guide the generation process (e.g., for ControlNet or image editing models). This field is only applicable when using ControlNet or image editing models.","uniqueKey":"control_images.oneOf.0","typeLabel":"ImageInput · object[]"},{"type":"null","title":"Control Images","description":"Optional input images used to condition or guide the generation process (e.g., for ControlNet or image editing models). This field is only applicable when using ControlNet or image editing models.","uniqueKey":"control_images.oneOf.1","typeLabel":"null"}],"uniqueKey":"control_images","typeLabel":"ImageInput · object[] | null"},"controlnet_weights":{"oneOf":[{"type":"array","items":{"type":"number","uniqueKey":"controlnet_weights.oneOf.0.items.[INDEX]","typeLabel":"number"},"title":"Controlnet Weights","description":"A list of weights that determine the influence of each ControlNet model in the generation process. Each value must be within [0, 1], where 0 disables the corresponding ControlNet and 1 applies it fully. When multiple ControlNet models are used, the list length must match the number of control images. If omitted, all ControlNet models default to full influence (1.0). This field is only applicable when using ControlNet models.","uniqueKey":"controlnet_weights.oneOf.0","typeLabel":"number[]"},{"type":"null","title":"Controlnet Weights","description":"A list of weights that determine the influence of each ControlNet model in the generation process. Each value must be within [0, 1], where 0 disables the corresponding ControlNet and 1 applies it fully. When multiple ControlNet models are used, the list length must match the number of control images. If omitted, all ControlNet models default to full influence (1.0). This field is only applicable when using ControlNet models.","uniqueKey":"controlnet_weights.oneOf.1","typeLabel":"null"}],"uniqueKey":"controlnet_weights","typeLabel":"number[] | null"}},"type":"object","required":["model","prompt"],"title":"DedicatedImageGenerationBody","example":{"model":"(endpoint-id)","num_inference_steps":10,"prompt":"An orange Lamborghini driving down a hill road at night with a beautiful ocean view in the background."},"uniqueKey":"","typeLabel":"DedicatedImageGenerationBody · object"},"examples":{"Example":{"title":"Example","value":{"model":"(endpoint-id)","num_inference_steps":10,"prompt":"An orange Lamborghini driving down a hill road at night with a beautiful ocean view in the background."}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"5dd82d9e-db23-4c3f-bb04-aa1272b91a50":{"description":"Successfully generated image(s).","content":{"application/json":{"schema":{"properties":{"data":{"oneOf":[{"type":"array","items":{"properties":{"seed":{"type":"integer","title":"Seed","description":"The seed used during image generation.","isRequired":true,"uniqueKey":"data.oneOf.0.items.[INDEX].seed","typeLabel":"integer"},"response_format":{"type":"string","enum":["url","raw","png","jpeg","jpg"],"title":"Response Format","description":"The format of the generated image. One of `url(default)`, `raw`, `png`, `jpeg`, and `jpg`.","isRequired":true,"uniqueKey":"data.oneOf.0.items.[INDEX].response_format","typeLabel":"enum\u003cstring>"},"url":{"type":"string","title":"Url","description":"The URL of the generated image.","isRequired":true,"uniqueKey":"data.oneOf.0.items.[INDEX].url","typeLabel":"string"}},"type":"object","required":["seed","response_format","url"],"title":"UrlImageItem","uniqueKey":"data.oneOf.0.items.[INDEX]","typeLabel":"UrlImageItem · object"},"title":"Data","isRequired":true,"uniqueKey":"data.oneOf.0","typeLabel":"UrlImageItem · object[]"},{"type":"array","items":{"properties":{"seed":{"type":"integer","title":"Seed","description":"The seed used during image generation.","isRequired":true,"uniqueKey":"data.oneOf.1.items.[INDEX].seed","typeLabel":"integer"},"response_format":{"type":"string","enum":["url","raw","png","jpeg","jpg"],"title":"Response Format","description":"The format of the generated image. One of `url(default)`, `raw`, `png`, `jpeg`, and `jpg`.","isRequired":true,"uniqueKey":"data.oneOf.1.items.[INDEX].response_format","typeLabel":"enum\u003cstring>"},"b64_json":{"type":"string","format":"binary","title":"B64 Json","description":"The base64-encoded JSON of the generated image.","isRequired":true,"uniqueKey":"data.oneOf.1.items.[INDEX].b64_json","typeLabel":"file"}},"type":"object","required":["seed","response_format","b64_json"],"title":"B64ImageItem","uniqueKey":"data.oneOf.1.items.[INDEX]","typeLabel":"B64ImageItem · object"},"title":"Data","isRequired":true,"uniqueKey":"data.oneOf.1","typeLabel":"B64ImageItem · object[]"}],"isRequired":true,"uniqueKey":"data","typeLabel":"UrlImageItem · object[] | B64ImageItem · object[]"}},"type":"object","required":["data"],"title":"DedicatedImageGenerateSuccess","uniqueKey":"","typeLabel":"DedicatedImageGenerateSuccess · object"},"examples":{"Example":{"title":"Example","value":{"data":[{"url":"(url-to-generated-image)","seed":123,"response_format":"url"}]}}},"exampleType":"examples"}},"exampleType":"examples"},"d774f344-2d69-474d-9a83-c03199a07618":{"description":"Unprocessable Entity","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}}},"security":{"46890439-ced6-4a43-9336-dc87718f9f99":{"token":{"type":"http","description":"When using Friendli Suite API, you need to provide a **Personal API Key** (e.g. flp_XXX) as a Bearer token for authentication and authorization purposes.\n\nFor more detailed information, please refer [here](https://friendli.ai/docs/openapi/introduction#authentication).","scheme":"bearer","scopes":[],"schemeName":"token"}}},"servers":{"6573dcb9-f1c7-4004-bf30-f967cb86a2a1":{"url":"https://api.friendli.ai"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","description":"When using Friendli Suite API, you need to provide a **Personal API Key** (e.g. flp_XXX) as a Bearer token for authentication and authorization purposes.\n\nFor more detailed information, please refer [here](https://friendli.ai/docs/openapi/introduction#authentication).","scheme":"bearer","scopes":[],"schemeName":"token"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"When using Friendli Suite API, you need to provide a **Personal API Key** (e.g. flp_XXX) as a Bearer token for authentication and authorization purposes.\n\nFor more detailed information, please refer [here](https://friendli.ai/docs/openapi/introduction#authentication).","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"token","name":"Authorization"}],"title":"token"}]},"originalFileLocation":"https://github.com/friendliai/friendli-openapi/raw/refs/heads/main/openapi.yaml"},"subdomain":"friendliai","siteName":"FriendliAI Docs","title":"Dedicated Image Generations","contextualStarterQuestions":[{"_id":"69fd749868c9a4a0bb4ed29e","deploymentId":"66d1620afd71f66abaace95b","questionText":"How do I authenticate?","status":"active","generatedBy":"contextual","path":"openapi/dedicated/inference/image-generations","createdAt":"2026-05-08T05:28:56.092Z","updatedAt":"2026-05-08T05:28:56.092Z","__v":0},{"_id":"69fd749868c9a4a0bb4ed29d","deploymentId":"66d1620afd71f66abaace95b","questionText":"What API key do I need?","status":"active","generatedBy":"contextual","path":"openapi/dedicated/inference/image-generations","createdAt":"2026-05-08T05:28:56.092Z","updatedAt":"2026-05-08T05:28:56.092Z","__v":0},{"_id":"69fd749868c9a4a0bb4ed29c","deploymentId":"66d1620afd71f66abaace95b","questionText":"How do I generate images?","status":"active","generatedBy":"contextual","path":"openapi/dedicated/inference/image-generations","createdAt":"2026-05-08T05:28:56.092Z","updatedAt":"2026-05-08T05:28:56.092Z","__v":0}],"navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-26T03:11:20.284Z","gitLastModified":"2026-06-09T01:14:16.000Z","originalFileLocation":"openapi/dedicated/inference/image-generations.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Generate an image from a text prompt.\">\u003cmeta data-mint-head name=\"application-name\" content=\"FriendliAI Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/friendliai/f_6Xi29vsyX4mJlf/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/docs/mintlify-assets/_mintlify/favicons/friendliai/f_6Xi29vsyX4mJlf/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/friendliai/f_6Xi29vsyX4mJlf/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/friendliai/f_6Xi29vsyX4mJlf/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/friendliai/f_6Xi29vsyX4mJlf/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/friendliai/f_6Xi29vsyX4mJlf/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/friendliai/f_6Xi29vsyX4mJlf/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/friendliai/f_6Xi29vsyX4mJlf/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/friendliai/f_6Xi29vsyX4mJlf/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Dedicated Image Generations\">\u003cmeta data-mint-head property=\"og:description\" content=\"Generate an image from a text prompt.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"FriendliAI Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://friendli.ai/docs/openapi/dedicated/inference/image-generations\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://friendliai.mintlify.site/docs/_mintlify/api/og/v2?division=Inference\u0026amp;title=Dedicated+Image+Generations\u0026amp;description=Generate+an+image+from+a+text+prompt.\u0026amp;theme=dd6dd98f885ae143c6c3d0cf\u0026amp;signature=e2b1d9cef204a8190a3ed9c235e00afe4c5c1032e2368683af61948a5402713d\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Dedicated Image Generations\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Generate an image from a text prompt.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://friendliai.mintlify.site/docs/_mintlify/api/og/v2?division=Inference\u0026amp;title=Dedicated+Image+Generations\u0026amp;description=Generate+an+image+from+a+text+prompt.\u0026amp;theme=dd6dd98f885ae143c6c3d0cf\u0026amp;signature=e2b1d9cef204a8190a3ed9c235e00afe4c5c1032e2368683af61948a5402713d\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/docs/mintlify-assets/_mintlify/favicons/friendliai/f_6Xi29vsyX4mJlf/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"FriendliAI Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#2A62DB\">\u003clink data-mint-head rel=\"canonical\" href=\"https://friendli.ai/docs/openapi/dedicated/inference/image-generations\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/openapi/dedicated/inference/image-generations.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://friendli.ai/#organization\",\"name\":\"FriendliAI Docs\",\"url\":\"https://friendli.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/friendliai/Xn-EfFlXFvptInk9/static/svgs/logo.svg?fit=max\u0026auto=format\u0026n=Xn-EfFlXFvptInk9\u0026q=85\u0026s=0a04a5dd2152a1258e6d3ce995b70eb0\"}},{\"@type\":\"WebSite\",\"@id\":\"https://friendli.ai/docs#website\",\"name\":\"FriendliAI Docs\",\"url\":\"https://friendli.ai/docs\",\"publisher\":{\"@id\":\"https://friendli.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://friendli.ai/docs/openapi/dedicated/inference/image-generations#webpage\",\"url\":\"https://friendli.ai/docs/openapi/dedicated/inference/image-generations\",\"name\":\"Dedicated Image Generations\",\"description\":\"Generate an image from a text prompt.\",\"dateModified\":\"2026-06-09T01:14:16.000Z\",\"isPartOf\":{\"@id\":\"https://friendli.ai/docs#website\"},\"breadcrumb\":{\"@id\":\"https://friendli.ai/docs/openapi/dedicated/inference/image-generations#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://friendli.ai/docs/openapi/dedicated/inference/image-generations#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Dedicated\",\"item\":\"https://friendli.ai/docs/openapi/dedicated/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Inference\",\"item\":\"https://friendli.ai/docs/openapi/dedicated/inference/chat-completions\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Dedicated Image Generations\",\"item\":\"https://friendli.ai/docs/openapi/dedicated/inference/image-generations\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://friendli.ai/docs/openapi/dedicated/inference/image-generations#apireference\",\"headline\":\"Dedicated Image Generations\",\"name\":\"Dedicated Image Generations\",\"description\":\"Generate an image from a text prompt.\",\"url\":\"https://friendli.ai/docs/openapi/dedicated/inference/image-generations\",\"mainEntityOfPage\":{\"@id\":\"https://friendli.ai/docs/openapi/dedicated/inference/image-generations#webpage\"},\"dateModified\":\"2026-06-09T01:14:16.000Z\",\"publisher\":{\"@id\":\"https://friendli.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://friendli.ai/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"FriendliAI Docs\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"FriendliAI Docs\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/docs/openapi/dedicated/inference/image-generations.md","siteName":"FriendliAI Docs","nav":{"global":{"anchors":[{"anchor":"Home","icon":"home","href":"https://friendli.ai"},{"anchor":"Models","icon":"brain","href":"https://friendli.ai/models"},{"anchor":"Pricing","icon":"tag","href":"https://friendli.ai/pricing"},{"anchor":"Blog","icon":"newspaper","href":"https://friendli.ai/blog"}]},"tabs":[{"tab":"Home","hidden":true,"searchable":true,"pages":[{"title":"Home","href":""}]},{"tab":"Guides","pages":[{"title":"Guides","href":"/guides/introduction/overview"}]},{"tab":"Examples","pages":[{"title":"Examples","href":"/examples/models/overview"}]},{"tab":"Reference","groups":[{"group":"API Reference","pages":[{"title":"API Reference","sidebarTitle":"Introduction","href":"/openapi/introduction"}]},{"group":"Model APIs","pages":[{"title":"Model APIs Overview","sidebarTitle":"Overview","href":"/openapi/model-apis/overview"},{"group":"Inference","pages":[{"title":"Model APIs Chat Completions","deprecated":null,"version":null,"sidebarTitle":"Chat Completions","openapi":"https://github.com/friendliai/friendli-openapi/raw/refs/heads/main/openapi.yaml post /serverless/v1/chat/completions","href":"/openapi/model-apis/chat-completions"},{"title":"Model APIs Responses","deprecated":null,"version":null,"sidebarTitle":"Responses","tag":"Beta","openapi":"https://github.com/friendliai/friendli-openapi/raw/refs/heads/main/openapi.yaml post /serverless/v1/responses","href":"/openapi/model-apis/responses"},{"title":"Model APIs Messages","deprecated":null,"version":null,"sidebarTitle":"Messages","tag":"Beta","openapi":"https://github.com/friendliai/friendli-openapi/raw/refs/heads/main/openapi.yaml post /serverless/v1/messages","href":"/openapi/model-apis/messages"},{"title":"Model APIs Chat Render","deprecated":null,"version":null,"sidebarTitle":"Chat Render","openapi":"https://github.com/friendliai/friendli-openapi/raw/refs/heads/main/openapi.yaml post /serverless/v1/chat/render","href":"/openapi/model-apis/chat-render"},{"title":"Model APIs Completions","deprecated":null,"version":null,"sidebarTitle":"Completions","openapi":"https://github.com/friendliai/friendli-openapi/raw/refs/heads/main/openapi.yaml post /serverless/v1/completions","href":"/openapi/model-apis/completions"},{"title":"Model APIs Tokenization","deprecated":null,"version":null,"sidebarTitle":"Tokenization","openapi":"https://github.com/friendliai/friendli-openapi/raw/refs/heads/main/openapi.yaml post /serverless/v1/tokenize","href":"/openapi/model-apis/tokenization"},{"title":"Model APIs Detokenization","deprecated":null,"version":null,"sidebarTitle":"Detokenization","openapi":"https://github.com/friendliai/friendli-openapi/raw/refs/heads/main/openapi.yaml post /serverless/v1/detokenize","href":"/openapi/model-apis/detokenization"},{"title":"Model APIs Audio Transcriptions","deprecated":null,"version":null,"sidebarTitle":"Audio Transcriptions","openapi":"https://github.com/friendliai/friendli-openapi/raw/refs/heads/main/openapi.yaml post /serverless/v1/audio/transcriptions","href":"/openapi/model-apis/audio-transcriptions"}]}]},{"group":"Dedicated","pages":[{"title":"Dedicated Overview","sidebarTitle":"Overview","href":"/openapi/dedicated/overview"},{"group":"Inference","pages":[{"title":"Dedicated Chat Completions","deprecated":null,"version":null,"sidebarTitle":"Chat Completions","openapi":"https://github.com/friendliai/friendli-openapi/raw/refs/heads/main/openapi.yaml post /dedicated/v1/chat/completions","href":"/openapi/dedicated/inference/chat-completions"},{"title":"Dedicated Responses","deprecated":null,"version":null,"sidebarTitle":"Responses","tag":"Beta","openapi":"https://github.com/friendliai/friendli-openapi/raw/refs/heads/main/openapi.yaml post /dedicated/v1/responses","href":"/openapi/dedicated/inference/responses"},{"title":"Dedicated Messages","deprecated":null,"version":null,"sidebarTitle":"Messages","tag":"Beta","openapi":"https://github.com/friendliai/friendli-openapi/raw/refs/heads/main/openapi.yaml post /dedicated/v1/messages","href":"/openapi/dedicated/inference/messages"},{"title":"Dedicated Chat Render","deprecated":null,"version":null,"sidebarTitle":"Chat Render","openapi":"https://github.com/friendliai/friendli-openapi/raw/refs/heads/main/openapi.yaml post /dedicated/v1/chat/render","href":"/openapi/dedicated/inference/chat-render"},{"title":"Dedicated Completions","deprecated":null,"version":null,"sidebarTitle":"Completions","openapi":"https://github.com/friendliai/friendli-openapi/raw/refs/heads/main/openapi.yaml post /dedicated/v1/completions","href":"/openapi/dedicated/inference/completions"},{"title":"Dedicated Embeddings","deprecated":null,"version":null,"sidebarTitle":"Embeddings","openapi":"https://github.com/friendliai/friendli-openapi/raw/refs/heads/main/openapi.yaml post /dedicated/v1/embeddings","href":"/openapi/dedicated/inference/embeddings"},{"title":"Dedicated Text Classification","deprecated":null,"version":null,"sidebarTitle":"Text Classification","openapi":"https://github.com/friendliai/friendli-openapi/raw/refs/heads/main/openapi.yaml post /dedicated/classify","href":"/openapi/dedicated/inference/text-classification"},{"title":"Dedicated Tokenization","deprecated":null,"version":null,"sidebarTitle":"Tokenization","openapi":"https://github.com/friendliai/friendli-openapi/raw/refs/heads/main/openapi.yaml post /dedicated/v1/tokenize","href":"/openapi/dedicated/inference/tokenization"},{"title":"Dedicated Detokenization","description":"Convert a list of token IDs back into text.","deprecated":null,"version":null,"sidebarTitle":"Detokenization","openapi":"https://github.com/friendliai/friendli-openapi/raw/refs/heads/main/openapi.yaml post /dedicated/v1/detokenize","href":"/openapi/dedicated/inference/detokenization"},{"title":"Dedicated Image Generations","deprecated":null,"version":null,"sidebarTitle":"Image Generations","openapi":"https://github.com/friendliai/friendli-openapi/raw/refs/heads/main/openapi.yaml post /dedicated/v1/images/generations","href":"/openapi/dedicated/inference/image-generations"},{"title":"Dedicated Image Edits","description":"Edit an image based on a text prompt.","deprecated":null,"version":null,"sidebarTitle":"Image Edits","openapi":"https://github.com/friendliai/friendli-openapi/raw/refs/heads/main/openapi.yaml post /dedicated/v1/images/edits","href":"/openapi/dedicated/inference/image-edits"},{"title":"Dedicated Audio Transcriptions","deprecated":null,"version":null,"sidebarTitle":"Audio Transcriptions","openapi":"https://github.com/friendliai/friendli-openapi/raw/refs/heads/main/openapi.yaml post /dedicated/v1/audio/transcriptions","href":"/openapi/dedicated/inference/audio-transcriptions"}]},{"group":"Endpoint","tag":"Beta","pages":[{"title":"Dedicated List Endpoints","deprecated":null,"version":null,"sidebarTitle":"List Endpoints","openapi":"https://github.com/friendliai/friendli-openapi/raw/refs/heads/main/openapi.yaml get /dedicated/beta/endpoint","href":"/openapi/dedicated/endpoint/list"},{"title":"Dedicated Get Endpoint","deprecated":null,"version":null,"sidebarTitle":"Retrieve an Endpoint Specification","openapi":"https://github.com/friendliai/friendli-openapi/raw/refs/heads/main/openapi.yaml get /dedicated/beta/endpoint/{endpoint_id}","href":"/openapi/dedicated/endpoint/get-spec"},{"title":"Dedicated Get Endpoint Version","deprecated":null,"version":null,"sidebarTitle":"Retrieve Endpoint Version History","openapi":"https://github.com/friendliai/friendli-openapi/raw/refs/heads/main/openapi.yaml get /dedicated/beta/endpoint/{endpoint_id}/version","href":"/openapi/dedicated/endpoint/get-version"},{"title":"Dedicated Get Endpoint Status","deprecated":null,"version":null,"sidebarTitle":"Retrieve an Endpoint Status","openapi":"https://github.com/friendliai/friendli-openapi/raw/refs/heads/main/openapi.yaml get /dedicated/beta/endpoint/{endpoint_id}/status","href":"/openapi/dedicated/endpoint/get-status"},{"title":"Dedicated Create Endpoint","deprecated":null,"version":null,"sidebarTitle":"Create an Endpoint","openapi":"https://github.com/friendliai/friendli-openapi/raw/refs/heads/main/openapi.yaml post /dedicated/beta/endpoint","href":"/openapi/dedicated/endpoint/create"},{"title":"Dedicated Update Endpoint","deprecated":null,"version":null,"sidebarTitle":"Update an Endpoint with New Configuration","openapi":"https://github.com/friendliai/friendli-openapi/raw/refs/heads/main/openapi.yaml put /dedicated/beta/endpoint/{endpoint_id}","href":"/openapi/dedicated/endpoint/update"},{"title":"Dedicated Terminate Endpoint","deprecated":null,"version":null,"sidebarTitle":"Terminate an Endpoint","openapi":"https://github.com/friendliai/friendli-openapi/raw/refs/heads/main/openapi.yaml put /dedicated/beta/endpoint/{endpoint_id}/terminate","href":"/openapi/dedicated/endpoint/terminate"},{"title":"Dedicated Restart Endpoint","deprecated":null,"version":null,"sidebarTitle":"Restart an Endpoint","openapi":"https://github.com/friendliai/friendli-openapi/raw/refs/heads/main/openapi.yaml put /dedicated/beta/endpoint/{endpoint_id}/restart","href":"/openapi/dedicated/endpoint/restart"},{"title":"Dedicated Sleep Endpoint","deprecated":null,"version":null,"sidebarTitle":"Sleep an Endpoint","openapi":"https://github.com/friendliai/friendli-openapi/raw/refs/heads/main/openapi.yaml put /dedicated/beta/endpoint/{endpoint_id}/sleep","href":"/openapi/dedicated/endpoint/sleep"},{"title":"Dedicated Wake Endpoint","deprecated":null,"version":null,"sidebarTitle":"Wake Up an Endpoint","openapi":"https://github.com/friendliai/friendli-openapi/raw/refs/heads/main/openapi.yaml put /dedicated/beta/endpoint/{endpoint_id}/wake","href":"/openapi/dedicated/endpoint/wake"},{"title":"Dedicated Delete Endpoint","deprecated":null,"version":null,"sidebarTitle":"Delete an Endpoint","openapi":"https://github.com/friendliai/friendli-openapi/raw/refs/heads/main/openapi.yaml delete /dedicated/beta/endpoint/{endpoint_id}","href":"/openapi/dedicated/endpoint/delete"}]}]},{"group":"Administration","tag":"Beta","pages":[{"title":"Cost","deprecated":null,"version":null,"sidebarTitle":"Cost","openapi":"https://github.com/friendliai/friendli-openapi/raw/refs/heads/main/openapi.yaml get /v1/team/cost","href":"/openapi/administration/cost"},{"title":"Usage","deprecated":null,"version":null,"sidebarTitle":"Usage","openapi":"https://github.com/friendliai/friendli-openapi/raw/refs/heads/main/openapi.yaml get /v1/team/usage","href":"/openapi/administration/usage"}]}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog"}]},{"tab":"Archive","hidden":true,"searchable":true,"pages":[{"title":"Archive","href":"/archive/container/guides/introduction"}]}]},"basePath":"","title":"Dedicated Image Generations","deploymentId":"dpl_B1qJC7o4Nbc1BrDLB8Y5TDHq3c2t","buildId":"dpl_B1qJC7o4Nbc1BrDLB8Y5TDHq3c2t","dynamics":["10e4515597","c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["BannerMarkdown-8Mh6Z8I6.js","dist-D0qiytnz.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js","OpenApiReferenceProvider-CUHhyXy2.js","snippetPresets-CLZ6zHrE.js","utils-YgZO0660.js","style-to-object-BY3JEAdk.js","utils-BfGpunL-.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-nXeJG4mW.js","conditional-requirements-CFM0id0Q.js","cloneDeep-CfiGwWS2.js","_Uint8Array-DMwpGz7v.js","isObject-FP1Yky1u.js","ApiExamples-ClwIRLsI.js","usePlaygroundInputsStore-D3zE52Kn.js","shallow-D4RQzCAp.js","isEqual-Ba6nq9eA.js","CodeSnippets-DK9iv102.js","CodeSnippet-CD0M-PIN.js","getApiPlaygroundDisplay-MZpK72mj.js","Page-wRPqmnTs.js","DynamicMarkdown-B4E-vXj3.js","SectionHeading-Cd1Hebqh.js","icon-CopWpdT0.js","MethodPill-DHN7T7vW.js","getPastedJson-BuLRhr5B.js","Check2Icon-DTvkZOnk.js","axios-CsQoIw0U.js","Markdown-BZDfk3ee.js","AssistantPageLink-CXXpl6Pb.js"]}