Call Agnes AI / Sapiens AI generation APIs for text, image, and video. Use when the user asks to use Agnes models, Agnes Image, Agnes Video, Agnes 2.0 Flash, apihub.agnes-ai.com, or to generate text, images, edit images, create videos, animate images, create keyframe videos, or test Agnes API calls.

Agnes AI Generation Use this skill to call Agnes text, image, and video generation APIs through https://apihub.agnes ai.com . Quick Start 1. Read references/api.md when endpoint details, parameters, or response fields are needed. 2. Use scripts/agnes api.py for real API calls instead of rewriting curl by hand. 3. Require an API key in AGNES API KEY , AGNES API TOKEN , or APIHUB AGNES API KEY . Never print the key. 4. For light live verification, run smoke test ; it avoids video creation by default. Add include image edit for image to image, and add video case <case explicitly for video modes. Treat the skill as fully tested only when basic text, text streaming, text tool calling, text to image, image to image, text to video, image to video, multi image video, keyframe video, and video retrieval return successful responses. Commands Text generation: Streaming text: Streaming output is normalized and includes aggregated content , events , done , and a short raw prefix . Image generation: Image to image: Text to video with polling: Image to video: Keyframe / multi image video: Retrieve a video task: Light live smoke test: Image edit smoke test: Single video smoke test: Workflow Prefer agnes 2.0 flash for text chat/completions. Do not use Agnes Responses API multi turn function calling for autonomous tool workflows. Live testing showed the provider can return function call with overall status=completed , and submitting function call output with previous response id may fail. Use this skill's chat completions path for text generation and treat tool calling as best effort request shape compatibility only. Prefer agnes image 2.1 flash for text to image, image to image, and high information density image generation. High density generation is prompt driven; include subject hierarchy, environment, secondary details, lighting, composition, and quality requirements. Prefer agnes video v2.0 for text to video, image to video, multi image video, keyframe animation, prompt based motion and scene control, cinematic output, asynchronous task creation, polling based result retrieval, and seed based reproducibility. For image and video generation, convert any non English user prompt to a fluent English generation prompt before calling the image/video API. English prompts are more stable for Agnes video generation. Preserve concrete visual details, style, lighting, composition, motion, camera instructions, and constraints during translation. For videos, remember the API is asynchronous: create a task first, then poll or retrieve by video id when the create response includes it. The script falls back to legacy task id lookup only when video id is absent. The script validates image sizes, video frame counts, frame rates, and dimensions before sending requests. num frames must be 8n + 1 and <= 441 ; 81 or 121 are good short values. The video command defaults to num frames=121 and frame rate=24 for more stable generation. Video smoke tests default to num frames=81 and frame rate=24 . Warn the user before costly or long running live video generation unless they explicitly asked to test or generate video. Test video capabilities one at a time with smoke test video case <case to avoid creating many tasks at once. Supported cases are text to video , image to video , multi image , and keyframes . Current Validation Notes Confirmed locally: skill metadata validation and Python syntax. Confirmed by live API: basic text, streaming text, tool calling request shape, text to image, image to image, high information density text to image, Chinese prompt translation for image/video, completed text to video URL retrieval, and completed image to video URL retrieval. Caveat: Agnes may accept tool calling request parameters without consistently returning tool calls ; use smoke test strict tools when strict tool call validation is required. Caveat: Agnes Responses API multi turn function calling is not reliable for agent tool loops; do not rely on it for Codex/Claude style automatic tool continuation. Supported by the script and smoke test selector, but not re run end to end in the latest pass: multi image video and keyframe animation. Not yet confirmed end to end: completed URL retrieval for every multi image video and keyframe animation task. A previous text to video task returned a provider side division by zero error, so keep video retries visible and report provider errors clearly. Output Handling Return generated image/video URLs directly by default. Do not download, save, open, or inspect generated media unless the user explicitly asks for a local file or visual inspection. For image responses, expect URL style results when extra body.response format is url . For video responses, extract URLs from video url , url , or remixed from video id when status is completed . For video retrieval, prefer GET /agnesapi?video id=...&model name=agnes video v2.0 ; legacy GET /v1/videos/{task id} remains a fallback. If a request fails, report HTTP status and provider error body without exposing the API key.

agnes-ai-generation