# GENGEN API

> Build video, image, and multimodal applications with the GENGEN API.

## Docs

- [Create an asset](https://docs.gengen.farm/api-reference/byteplus/assets/create-asset.md): Upload an image, video, or audio asset; preprocessing is asynchronous, so use it only after its status becomes Active.
- [Create an asset group](https://docs.gengen.farm/api-reference/byteplus/assets/create-asset-group.md): Create a virtual-portrait asset group in the current GENGEN workspace.
- [Create a real-person verification session](https://docs.gengen.farm/api-reference/byteplus/assets/create-real-human-session.md): Create a single-use H5 verification session; save the token and complete the flow within 120 seconds.
- [Delete an asset](https://docs.gengen.farm/api-reference/byteplus/assets/delete-asset.md): Permanently delete one asset from a workspace-owned asset group; this operation is irreversible.
- [Delete an asset group](https://docs.gengen.farm/api-reference/byteplus/assets/delete-asset-group.md): Permanently delete a group and all its assets; deletion is irreversible and real-person authorization must permit it.
- [Get an asset](https://docs.gengen.farm/api-reference/byteplus/assets/get-asset.md): Retrieve an asset and its preprocessing status; signed asset URLs expire after 12 hours.
- [Get an asset group](https://docs.gengen.farm/api-reference/byteplus/assets/get-asset-group.md): Retrieve details for one asset group owned by the current workspace.
- [Get a real-person verification result](https://docs.gengen.farm/api-reference/byteplus/assets/get-real-human-result.md): Retrieve the real-person group ID after a successful H5 callback, before the single-use token expires.
- [List asset groups](https://docs.gengen.farm/api-reference/byteplus/assets/list-asset-groups.md): List workspace asset groups; wait for a group to become active before creating or managing assets.
- [List assets](https://docs.gengen.farm/api-reference/byteplus/assets/list-assets.md): List assets with filtering, sorting, and pagination; returned signed URLs expire after 12 hours.
- [List public assets](https://docs.gengen.farm/api-reference/byteplus/assets/public-assets.md): Search the public asset library; results contain thumbnails but omit original and full-size asset URLs.
- [Update an asset](https://docs.gengen.farm/api-reference/byteplus/assets/update-asset.md): Rename an asset owned by the current GENGEN workspace.
- [Update an asset group](https://docs.gengen.farm/api-reference/byteplus/assets/update-asset-group.md): Update the name or description of an asset group owned by the current workspace.
- [Generate images](https://docs.gengen.farm/api-reference/byteplus/image-generation/create-image.md): Generate one or more images synchronously. New integrations should use normalized `assets`, `controls`, and `providerOptions` fields and read generated media from `outputs.images`. The returned `id` identifies this completed request for logs; it is not a task ID to poll.
- [Create a chat completion](https://docs.gengen.farm/api-reference/byteplus/text-generation/chat-completions.md): Create an OpenAI-compatible BytePlus chat completion. Set `stream` to `true` to receive Server-Sent Events ending with `data: [DONE]`. For a streaming request, GENGEN always enables final usage reporting.
- [Cancel or delete a video generation task](https://docs.gengen.farm/api-reference/byteplus/video-generation/cancel-task.md): Cancel a queued task or delete a terminal task where the selected provider supports the operation. This changes remote and local task state and releases any applicable wallet hold.
- [Create a video generation task](https://docs.gengen.farm/api-reference/byteplus/video-generation/create-task.md): Submit an asynchronous BytePlus Seedance video generation task. This reference intentionally documents only the BytePlus models and parameters, even though other providers use the same public GENGEN endpoint.
- [List video generation tasks](https://docs.gengen.farm/api-reference/byteplus/video-generation/list-tasks.md): List video tasks persisted in the current GENGEN workspace. This endpoint does not refresh task status from the upstream provider.
- [Retrieve a video generation task](https://docs.gengen.farm/api-reference/byteplus/video-generation/retrieve-task.md): Retrieve the latest task state from the selected provider. A successful terminal retrieval can finalize the wallet charge associated with the task. Use the same API key that created the task; another key in the same workspace cannot retrieve it.
- [Create a video understanding response](https://docs.gengen.farm/api-reference/byteplus/video-understanding/create-response.md): Analyze a video with the BytePlus Responses API. Supply a provider-recognized `file_id`, a public URL, or a Base64 data URL. Streaming is not supported; the upstream Responses API object is returned as a single JSON document.
- [Create a Flash VSR task](https://docs.gengen.farm/api-reference/flash-vsr/video-upscale/create-task.md): Create an asynchronous Flash VSR task to upscale a public MP4 video.
- [Delete Flash VSR task](https://docs.gengen.farm/api-reference/flash-vsr/video-upscale/delete-task.md): Delete a Flash VSR task with its public GENGEN task ID.
- [Retrieve Flash VSR task](https://docs.gengen.farm/api-reference/flash-vsr/video-upscale/retrieve-task.md): Retrieve normalized status and upscaled video outputs for a Flash VSR task.
- [Create a Happy Horse video task](https://docs.gengen.farm/api-reference/happy-horse/video-generation/create-task.md): Create a Happy Horse 1.1 text-to-video, first-frame, or reference-to-video task.
- [Retrieve Happy Horse video task](https://docs.gengen.farm/api-reference/happy-horse/video-generation/retrieve-task.md): Retrieve normalized status and video outputs for a Happy Horse 1.1 task.
- [API reference](https://docs.gengen.farm/api-reference/introduction.md): Conventions shared by GENGEN v1 endpoints.
- [Generate or edit images with Qwen Image 3.0](https://docs.gengen.farm/api-reference/qwen/image-generation/qwen-image-3-0.md): Generate or edit images synchronously with Qwen Image 3.0.
- [Create a Qwen image edit task](https://docs.gengen.farm/api-reference/qwen/image-generation/qwen-image-edit.md): Create an asynchronous Qwen image edit task.
- [Retrieve a Qwen image edit task](https://docs.gengen.farm/api-reference/qwen/image-generation/qwen-image-edit/tasks.md): Retrieve status and edited images for a Qwen image edit task.
- [Delete a Qwen image edit task](https://docs.gengen.farm/api-reference/qwen/image-generation/qwen-image-edit/tasks-delete.md): Delete a Qwen image edit task owned by the current API key scope.
- [Create a Wan face swap task](https://docs.gengen.farm/api-reference/wan/image-generation/face-swap.md): Create an asynchronous Wan face swap task from two source images.
- [Retrieve a Wan face swap task](https://docs.gengen.farm/api-reference/wan/image-generation/face-swap/tasks.md): Retrieve status and image output for a Wan face swap task.
- [Delete a Wan face swap task](https://docs.gengen.farm/api-reference/wan/image-generation/face-swap/tasks-delete.md): Delete a Wan face swap task owned by the current API key scope.
- [Create a z-image task](https://docs.gengen.farm/api-reference/wan/image-generation/z-image.md): Create an asynchronous z-image text-to-image task.
- [Retrieve a z-image task](https://docs.gengen.farm/api-reference/wan/image-generation/z-image/tasks.md): Retrieve status and image outputs for a z-image task.
- [Delete a z-image task](https://docs.gengen.farm/api-reference/wan/image-generation/z-image/tasks-delete.md): Delete a z-image task owned by the current API key scope.
- [Create a Wan video task](https://docs.gengen.farm/api-reference/wan/video-generation/create-task.md): Create a Wan 2.7 image-to-video or Wan Animate motion-transfer task.
- [Delete Wan video task](https://docs.gengen.farm/api-reference/wan/video-generation/delete-task.md): Cancel or delete a Wan 2.7 or Wan Animate task.
- [Retrieve Wan video task](https://docs.gengen.farm/api-reference/wan/video-generation/retrieve-task.md): Retrieve status and video outputs for a Wan 2.7 or Wan Animate task.
- [Create a WonderClip image task](https://docs.gengen.farm/api-reference/wonderclip/image-generation/create-task.md): Create an asynchronous WonderClip text-to-image or image-to-image task.
- [Retrieve a WonderClip image task](https://docs.gengen.farm/api-reference/wonderclip/image-generation/retrieve-task.md): Retrieve status and image outputs for a WonderClip image task.
- [Create a WonderClip video task](https://docs.gengen.farm/api-reference/wonderclip/video-generation/create-task.md): Create a WonderClip text, frame-guided, or multimodal video generation task.
- [Retrieve WonderClip video task](https://docs.gengen.farm/api-reference/wonderclip/video-generation/retrieve-task.md): Retrieve normalized status and video outputs for a WonderClip task.
- [Authentication](https://docs.gengen.farm/authentication.md): Authenticate GENGEN API requests with a workspace API key.
- [Generate videos with face assets](https://docs.gengen.farm/face-assets-video-generation.md): Prepare public or private face assets for compliant Seedance video generation.
- [FAQ](https://docs.gengen.farm/faq.md): Answers to common GENGEN authentication, billing, generation, troubleshooting, file, and asset questions.
- [Compatibility](https://docs.gengen.farm/help/compatibility.md): Migrate legacy task paths and response aliases without disrupting existing clients.
- [Errors](https://docs.gengen.farm/help/errors.md): Handle GENGEN API error responses.
- [BytePlus provider error reference](https://docs.gengen.farm/help/provider-errors.md): Search BytePlus ModelArk error codes that can appear in proxied GENGEN responses.
- [Helpful tips](https://docs.gengen.farm/helpful-tips.md): Resolve common generation failures and choose the right portrait asset workflow.
- [GENGEN API](https://docs.gengen.farm/index.md): Build video, image, and multimodal applications with one consistent API.
- [DeepSeek V4 Flash](https://docs.gengen.farm/models/deepseek-v4-flash-260425.md): Low-cost DeepSeek text generation model for long-context chat completions.
- [DeepSeek V4 Pro](https://docs.gengen.farm/models/deepseek-v4-pro-260425.md): Higher-capability DeepSeek text generation model for long-context chat completions.
- [Seed 2.1 Turbo](https://docs.gengen.farm/models/dola-seed-2-1-turbo-260628.md): Production-grade multimodal reasoning model for coding, long-horizon agent execution, video understanding, and structured output.
- [Seedream 5.0 Pro](https://docs.gengen.farm/models/dola-seedream-5-0-pro-260628.md): Professional Seedream 5.0 image generation and editing model with precise region-based editing and support for up to 10 reference images.
- [Seedance 2.0](https://docs.gengen.farm/models/dreamina-seedance-2-0-260128.md): Professional multimodal video generation model for image, video, audio, and text conditioned creation, video editing, and video extension.
- [Seedance 2.0 Fast](https://docs.gengen.farm/models/dreamina-seedance-2-0-fast-260128.md): Faster multimodal video generation model that keeps the core Seedance 2.0 capabilities for image, video, audio, and text conditioned creation, video editing, and video extension.
- [Seedance 2.0 Mini](https://docs.gengen.farm/models/dreamina-seedance-2-0-mini-260615.md): Lower-cost Seedance 2.0 video generation model with the same request and response surface as Seedance 2.0 Fast.
- [Flash VSR](https://docs.gengen.farm/models/flashvsr.md): Video upscale model for increasing source video resolution while preserving detail and reducing noise.
- [GLM 5.2](https://docs.gengen.farm/models/glm-5-2-260617.md): GLM 5.2 text generation model for chat completions with high reasoning-token support.
- [Happy Horse 1.1](https://docs.gengen.farm/models/happyhorse-1.1.md): Asynchronous Happy Horse 1.1 video generation with text-to-video, image-to-video, and reference-to-video modes.
- [Models](https://docs.gengen.farm/models/overview.md): Select a public model ID for each generation request.
- [Qwen Image 3.0](https://docs.gengen.farm/models/qwen-image-3-0.md): Synchronous Qwen Image 3.0 generation and editing through Alibaba Cloud Model Studio.
- [Qwen Image Edit](https://docs.gengen.farm/models/qwen-image-edit-spicy.md): Asynchronous image editing model that modifies an input image from text instructions.
- [Seed 2.0 Code Preview](https://docs.gengen.farm/models/seed-2-0-code-preview-260328.md): Seed 2.0 code preview model for coding-oriented chat completions with text, image, and video inputs.
- [Seed 2.0 Lite](https://docs.gengen.farm/models/seed-2-0-lite-260428.md): Balanced Seed 2.0 omnimodal model for production chat, video understanding, and lower-cost multimodal reasoning.
- [Seed 2.0 Mini](https://docs.gengen.farm/models/seed-2-0-mini-260428.md): Lowest-cost Seed 2.0 text model for high-throughput chat completions with text, image, audio, and video inputs.
- [Seed 2.0 Pro](https://docs.gengen.farm/models/seed-2-0-pro-260328.md): Flagship all-purpose reasoning model designed for complex reasoning, long-chain task execution, multimodal understanding, structured generation, and tool-augmented execution.
- [Seedance 1.5 Pro](https://docs.gengen.farm/models/seedance-1-5-pro-251215.md): Seedance 1.5 Pro video generation model for text-to-video, first-frame image-to-video, and first-and-last-frame image-to-video.
- [Seedream 5.0 Lite](https://docs.gengen.farm/models/seedream-5-0-260128.md): Latest image generation model supporting text, single-image, and multi-image inputs, optimized for stronger prompt understanding, network-enhanced timeliness, and professional visual creation.
- [Wan Animate](https://docs.gengen.farm/models/wan-animate.md): Character animation model that transfers the motion from a reference video to a subject supplied in a source image.
- [Wan Face Swap](https://docs.gengen.farm/models/wan-face-swap.md): Asynchronous face swap model that transfers a source face onto a target image while preserving the target pose, lighting, and background.
- [Wan 2.7 Image-to-Video](https://docs.gengen.farm/models/wan2.7-i2v-spicy.md): Image-to-video model for generating high-resolution videos from a reference image and text prompt, with optional audio guidance and prompt rewriting.
- [WonderClip Banana Pro](https://docs.gengen.farm/models/wonder-banana-pro.md): WonderClip Banana Pro asynchronous image generation through WonderClip.
- [WonderClip Happy Horse 1.0](https://docs.gengen.farm/models/wonder-happyhorse-1.0.md): WonderClip Happy Horse 1.0 asynchronous video generation through WonderClip.
- [WonderClip Happy Horse 1.1](https://docs.gengen.farm/models/wonder-happyhorse-1.1.md): WonderClip Happy Horse 1.1 asynchronous video generation through WonderClip.
- [WonderClip Image 2](https://docs.gengen.farm/models/wonder-image-2.md): WonderClip Image 2 asynchronous image generation through WonderClip.
- [WonderClip Pro](https://docs.gengen.farm/models/wonder-pro.md): WonderClip Pro asynchronous video generation through WonderClip.
- [WonderClip Standard](https://docs.gengen.farm/models/wonder-standard.md): WonderClip Standard asynchronous video generation through WonderClip.
- [z-image Text-to-Image](https://docs.gengen.farm/models/z-image-spicy.md): Asynchronous text-to-image generation model with custom output dimensions and optional prompt rewriting.
- [Pricing](https://docs.gengen.farm/pricing.md): View current GENGEN model prices and understand when usage is charged.
- [Quickstart](https://docs.gengen.farm/quickstart.md): Create a video generation task and retrieve its result.

## OpenAPI Specs

- [wonderclip-video](https://docs.gengen.farm/openapi/wonderclip-video.yaml)
- [wonderclip-image](https://docs.gengen.farm/openapi/wonderclip-image.yaml)
- [wan-z-image](https://docs.gengen.farm/openapi/wan-z-image.yaml)
- [wan-video](https://docs.gengen.farm/openapi/wan-video.yaml)
- [wan-face-swap](https://docs.gengen.farm/openapi/wan-face-swap.yaml)
- [qwen-image-edit](https://docs.gengen.farm/openapi/qwen-image-edit.yaml)
- [qwen-image-3](https://docs.gengen.farm/openapi/qwen-image-3.yaml)
- [happy-horse-video](https://docs.gengen.farm/openapi/happy-horse-video.yaml)
- [gengen-v1](https://docs.gengen.farm/openapi/gengen-v1.yaml)
- [flash-vsr-video](https://docs.gengen.farm/openapi/flash-vsr-video.yaml)
- [byteplus-assets](https://docs.gengen.farm/openapi/byteplus-assets.yaml)