---
title: "Features"
description: "What the PixAI API can do: text-to-image with anime models and LoRAs, reference images, inpainting and outpainting, image-to-video and reference video, plus how tasks, credits and limits work."
canonical: "https://platform.pixai.art/en/docs/features"
last-updated: "2026-11-17"
---

# Features

What the PixAI API can do: text-to-image with anime models and LoRAs, reference images, inpainting and outpainting, image-to-video and reference video, plus how tasks, credits and limits work.



The PixAI API runs the same anime models and community LoRAs as [pixai.art](https://pixai.art/), so your application can generate what pixai.art users generate. This page lists what the API can do, how it works and what it does not cover yet, with links to the reference for each feature.

What you can generate [#capabilities]

| Feature                      | Endpoint                                                                          | What it does                                                                                                                  |
| ---------------------------- | --------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------- |
| Text to image                | [`POST /v2/image/create`](/en/docs/api-v2/image/createImage)                      | Generates 1 or 4 images from a prompt with a PixAI model, optional LoRAs, style presets and color palettes.                   |
| Reference images             | [`POST /v2/image/create`](/en/docs/api-v2/image/createImage) with `contextImages` | Uses up to 3 images as references, for example to keep a character consistent or take a pose from another image.              |
| Inpaint, outpaint and redraw | [`POST /v2/gen-task/inpaint`](/en/docs/api-v2/image/createInpaint)                | Redraws a masked area, extends an image beyond its edges, or redraws a whole image.                                           |
| Image to video               | [`POST /v2/frame-video/create`](/en/docs/api-v2/video/createFrameVideo)           | Animates an image into a 5–15 second clip with the Tsubaki video model, optionally ending on a second image and adding sound. |
| Reference video              | [`POST /v2/reference-video/create`](/en/docs/api-v2/video/createReferenceVideo)   | Generates a video guided by reference images and, depending on the model, reference videos and audio.                         |
| Models and LoRAs             | [`GET /v2/generation-model/search`](/en/docs/api-v2/model/searchGenerationModels) | Searches the [PixAI Model Market](https://pixai.art/model) for base models and LoRAs to generate with.                        |

Images [#images]

* **Models:** PixAI's own models, such as Tsubaki.3, Tsubaki.2, Haruka v2 and Hoshino v2, and other base models on the Model Market. See [Models](/en/docs/references/models).
* **Sizes:** 11 aspect ratios from `1:3` to `3:1`, in two resolution tiers (`1k` and `1.5k`). For other sizes, such as Tsubaki.3's larger outputs, send an exact `width` and `height` within the model's size ranges. See [Supported resolutions](/en/docs/references/supported-resolutions).
* **Quality and speed:** `mode` chooses an inference profile: `lite`, `standard`, `pro` or `ultra`. Not every mode is available on every model or plan.
* **LoRAs:** apply up to 3 LoRAs without a membership and up to 15 with one, each with its own weight. A LoRA must be made for the same base model as the generation model.
* **Prompting:** prompts of up to 10,000 characters on Tsubaki.2 and Tsubaki.3 (4,096 on other models), a negative prompt, a fixed `seed` for repeatable results, and an optional prompt helper that expands short prompts.
* **Styles and colors:** named `style` presets, and color palettes on Tsubaki.3.

Image editing [#editing]

* **Inpaint:** redraw the area a mask marks white.
* **Outpaint:** place the image on a larger canvas and fill in the new area.
* **Redraw:** redraw the whole image without a mask; `strength` sets how far the result may move from the original.

See the [Inpainting and Outpainting example](/en/docs/quick-start/examples/inpainting-and-outpainting) for the mask format.

Video [#video]

| Endpoint        | Models                           | References                                    | Length |
| --------------- | -------------------------------- | --------------------------------------------- | ------ |
| Image to video  | Tsubaki (`tbkv1.0.1`, `tbkv1.0`) | First frame, optional last frame              | 5–15 s |
| Reference video | Tsubaki                          | 1–6 images, up to 3 audio clips               | 5–15 s |
| Reference video | Seedance 2, Seedance 2 Fast      | Up to 9 images, 3 videos and 3 audio clips    | 4–15 s |
| Reference video | Seedance 2.5                     | Up to 30 images, 10 videos and 10 audio clips | 4–30 s |
| Reference video | Vidu                             | 1–7 images                                    | 3–16 s |

Both video endpoints can generate a soundtrack, with speech in English, Japanese, Korean or Chinese, or no speech. `professional` mode adds an upscale on supported models. Image to video needs a PixAI membership.

How it works [#how-it-works]

* **REST over HTTPS** at `https://api.pixai.art`, authenticated with an API key sent as `Authorization: Bearer <key>`. See [How can I use PixAI API?](/en/docs/quick-start/enroll-in-api)
* **Asynchronous tasks:** every generation endpoint returns a task. Poll [`GET /v2/task/{id}`](/en/docs/api-v2/task/getTask) until it is `completed`, `failed` or `cancelled`, or receive status updates by [webhook](/en/docs/references/webhook).
* **Media IDs:** inputs and outputs are media IDs. Upload your own images and audio with the upload endpoints, or reuse an image you generated. [`GET /v2/media/batch`](/en/docs/api-v2/media/batchGetMedia) turns media IDs into download URLs.
* **Download your results:** generated media is not kept forever, so store the files you need soon after a task finishes.
* **Private by default:** generations made through the API do not appear in your public generation history on pixai.art.
* **Machine-readable docs:** an [OpenAPI spec](/openapi.json), [llms.txt](/llms.txt), a Markdown version of every page and a [docs MCP server](/en/docs/docs-mcp) for coding agents.

To try it end to end, follow [Your First API Call](/en/docs/quick-start/first-api-call).

How credits are charged [#credits]

The API spends the credits of the PixAI account that owns the API key.

* **When:** credits are charged when a task is created. A task that fails is refunded.
* **How much:** the cost depends on what you ask for.
  * Images: the model, the output size, the `mode` and the batch size.
  * Inpaint, outpaint and redraw: the image size and `strength`.
  * Video: the model, the duration, `professional` mode and whether a soundtrack is generated.
* **Where to see it:** each task's `paidQuota` field shows the credits it was charged. Run a request once to see what it costs before you run it at scale.

Some options need a PixAI membership, such as image to video, more than 3 LoRAs and some sizes and modes. A request for an option your plan does not include is refused with an error.

Limits [#limits]

* Up to 10 tasks per account can wait in the queue at once. Tasks that are running do not count, and the cap can be raised per account.
* Poll a task no more than once every 1.5 seconds, and back off when you retry.

See [Limits](/en/docs/quick-start/limits) for details.

Not available in the API yet [#not-available]

PixAI Reference Pro, PixAI Edit and PixAI Edit Lite are available on pixai.art but not through the API yet. They are under active development.

Ownership and commercial use [#commercial-use]

You own the copyright to the images you generate through the API, and PixAI claims none over them. Approved users may use PixAI's official models, such as Tsubaki and Haruka, for commercial work, but may not resell or redistribute the model files. Generated content must not infringe third-party rights. See [Copyright and related rights](/en/docs/about/copyright).

Next steps [#next-steps]

* [Quick Start](/en/docs/quick-start): get an API key and make your first request.
* [Examples](/en/docs/quick-start#steps): complete scripts for image to video, consistent characters, inpainting and LoRAs.
* [API v2 reference](/en/docs/api-v2/image/createImage): every parameter of every endpoint.
