{"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_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_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)"}},{"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"}