{"authentication":{"header":"Authorization: Bearer \u003cyour-api-key\u003e","type":"Bearer token"},"base_url":"https://api.hinow.ai/v1","description":"Unified AI inference API — OpenAI-compatible endpoints for text, image, video, audio, 3D, and embeddings. One API key, 80+ models, automatic provider fallback.","discovery":{"categories":["text_to_text","image_to_text","text_to_image","image_to_image","image_editing","image_tools","text_to_video","image_to_video","audio_to_video","video_to_video","text_to_audio","audio_to_text","text_to_embedding","text_to_decision","text_to_3d","image_to_3d"],"description":"Use these endpoints to explore available models and their parameters","examples":["GET /v1/models?category=text_to_image — list all image generation models","GET /v1/models?category=text_to_image,image_to_image — multiple categories","GET /v1/models/qwen/qwen-image — full details with parameters and pricing"],"filter_by_type":"GET /v1/models?category={type}","list_all":"GET /v1/models","model_details":"GET /v1/models/{model_id}"},"endpoints":{"authenticated":[{"categories":["text_to_text","image_to_text"],"description":"Text generation and chat (OpenAI-compatible)","example":{"messages":[{"content":"Hello!","role":"user"}],"model":"qwen/qwen3-235b"},"method":"POST","path":"/v1/chat/completions","request_body":{"messages":"array — [{role, content}] (required)","model":"string — model ID (required)","stream":"boolean — enable SSE streaming (optional)"}},{"categories":["text_to_text","image_to_text"],"description":"Responses API (OpenAI-compatible) — server-side conversation state via previous_response_id","example":{"input":"Hello!","model":"hinow/higenesis"},"method":"POST","notes":"stream is not supported here yet — use /v1/chat/completions for SSE","path":"/v1/responses","request_body":{"input":"string or array — turn content, incl. function_call_output items (required)","instructions":"string — system prompt for this turn (optional)","model":"string — model ID (required)","previous_response_id":"string — chains onto a stored response (optional)","tools":"array — [{type:function, name, description, parameters}] (optional)"}},{"categories":["text_to_image","image_to_image","image_editing"],"description":"Image generation and editing — returns binary image data","example":{"model":"qwen/qwen-image","parameters":{"aspect_ratio":"16:9","output_format":"png"},"prompt":"A sunset over the ocean"},"method":"POST","path":"/v1/images","request_body":{"images":"array — image URLs for editing/img2img (optional)","model":"string — model ID (required)","parameters":"object — model-specific parameters (optional, see models list below)","prompt":"string — text description (required)"}},{"categories":["text_to_video","image_to_video","audio_to_video","video_to_video"],"description":"Video generation — text-to-video, image-to-video, audio-to-video, video-to-video","example":{"model":"google/veo-31-lite","parameters":{"aspect_ratio":"16:9","duration":8},"prompt":"A cinematic drone shot of a mountain lake at sunrise"},"method":"POST","path":"/v1/videos","request_body":{"images":"array — image/video URLs (required for image/video-to-video)","model":"string — model ID (required)","parameters":"object — model-specific parameters (optional, see models list below)","prompt":"string — text description (required for text/image-to-video)"}},{"categories":["text_to_audio","audio_generation"],"description":"Text-to-speech — returns binary audio data","example":{"model":"inworld/tts-1.5-max","parameters":{"voice_id":"Amelia"},"prompt":"Hello, world!"},"method":"POST","path":"/v1/audio/speech","request_body":{"model":"string — model ID (required)","parameters":"object — {voice_id, output_format, ...} (optional)","prompt":"string — text to speak (required)"}},{"categories":["audio_to_text"],"description":"Speech-to-text / audio transcription","method":"POST","path":"/v1/audio/transcriptions"},{"categories":["text_to_embedding"],"description":"Text embeddings (OpenAI-compatible)","example":{"input":"The quick brown fox","model":"qwen/qwen3-embedding-8b"},"method":"POST","path":"/v1/embeddings","request_body":{"input":"string|array — text(s) to embed (required)","model":"string — model ID (required)"}},{"categories":["text_to_decision"],"description":"Structured decisions (System One models): send a state and typed questions, get typed answers with calibrated probabilities instead of generated text","example":{"model":"typesafe/jev-1.13","questions":{"refund":{"instructions":"Does this message request a refund?","type":"noul"},"team":{"criteria":{"billing":"Charges, refunds, invoices","technical":"Bugs, outages, integrations"},"instructions":"Which team should handle this ticket?","type":"choice"}},"state":"I was charged twice this month and I want my money back."},"method":"POST","path":"/v1/decisions","request_body":{"model":"string — model ID (required)","questions":"object — name → {type: choice|score|noul, instructions, criteria} (required)","state":"string|object|array — the content to evaluate (required)"}},{"description":"Check your account balance","method":"GET","path":"/v1/balance"},{"description":"Web search via Serper","example":{"query":"latest AI news"},"method":"POST","path":"/v1/tools/search"},{"description":"Run a published AI agent (dedicated service: agents.hinow.ai)","method":"POST","path":"https://agents.hinow.ai/v1/agents/{agent_id}/run"}],"public":[{"description":"Service health check","method":"GET","path":"/health"},{"description":"List all available models with pricing and capabilities","method":"GET","path":"/v1/models"},{"description":"Get details for a specific model (includes inputs, parameters, cost)","method":"GET","path":"/v1/models/{model_id}"}]},"name":"HINOW Hub API","notes":["All authenticated endpoints require Authorization: Bearer \u003capi-key\u003e","Use the discovery endpoints above to find models and their parameters","Parameters go inside the 'parameters' object in the request body","Images can be passed as URLs in the 'images' array field","The API returns binary file data (image/video/audio) on success","Billing is automatic — check /v1/balance for your current credits"],"version":"1.0"}