Bearer auth
Send your API key in the Authorization header for generation, status and history requests.
Developer API
HiDream O1 Image 1.5 API integration method.
Call the public HiDream O1 Image 1.5 endpoints from your own backend with an API key, submit text-to-image jobs, poll status and read generation history.
Generation workflow
Submit prompts, monitor generation progress and retrieve completed images through documented endpoints.
Credit-aware
HiDream O1 Image 1.5 generations normally cost 4 credits per image.
Authentication
Create an API key in your account, then send it as Authorization: Bearer <YOUR_API_KEY>. Keep the key on your server and never expose it in public browser code.
Request format
Use JSON requests for prompt, size, sampling steps, guidance scale, output format and optional negative prompt. Status and history responses return the task state and generated result URLs when available.
Generate an image
curl -X POST https://hidreamimage.com/api/image/hidream-o1-image-1.5/generate \
-H "Authorization: Bearer <YOUR_API_KEY>" \
-H "Content-Type: application/json" \
-d '{
"prompt": "A clean product poster for a silver perfume bottle, readable headline, studio lighting",
"size": "16:9",
"num_inference_steps": 28,
"guidance_scale": 4,
"output_format": "jpeg"
}'Check status
curl "https://hidreamimage.com/api/image/hidream-o1-image-1.5/status?task_id=<TASK_ID>" \
-H "Authorization: Bearer <YOUR_API_KEY>"List recent tasks
curl "https://hidreamimage.com/api/image/hidream-o1-image-1.5/list?page=1&limit=12" \
-H "Authorization: Bearer <YOUR_API_KEY>"Get an API key
Sign in, create or copy your API key, and store it in your backend secret manager.
Submit a prompt
POST to the generation endpoint with prompt, size, optional negative prompt and output format.
Poll and show results
Use task_id to query status, then render completed image URLs in your own product flow.
Does the API use the same credits?
Yes. API generations use the same credit system as the online workspace, and HiDream O1 Image 1.5 normally costs 4 credits per image.
Should I call the API from frontend JavaScript?
No. Call it from your backend so the API key stays private. Your frontend should call your own server, not store the key in browser code.