Connect with other users for tips and advice. For immediate help, email support@heygen.com.

Ask the community

got the API beta invite (web credits through v3 API) but every v3 generation fails with requires 'api' credits and remaining_quota is 0.

 — I'm enrolled in the beta that lets a web-subscription plan's credits be used directly through the API on 

. Every v3 POST /v3/videos job is accepted (HTTP 200, video_id), then

fails at render with "Insufficient credit. This operation requires 'api' credits." — even though the account holds 

. GET /v2/user/remaining_quota reports remaining_quota: 0. This

. It looks like the beta's web→API credit entitlement isn't actually provisioned on the account/keys.

"…for this beta you can use your existing web subscription credits directly through the API. No separate API plan required: just generate an API key and start building. This beta benefit currently

- Auth: X-Api-Key (3 distinct keys generated from the dashboard, same account — identical behavior on all 3).

... (other *_free_credit fields, all small)

plan_credit: 996 is present but remaining_quota: 0, and generation deducts from the api/remaining_quota pool — so nothing renders.

Observed — POST /v3/videos accepts, render fails on credit

{ "type":"avatar", "avatar_id":"<photo_avatar_id>", "voice_id":"<voice>",

→ 200 { "data": { "status":"waiting", "video_id":"ea319c9ce9ca41d3bc48c78abefb39f8" } }

GET /v3/videos/ea319c9ce9ca41d3bc48c78abefb39f8

"failure_code":"MOVIO_PAYMENT_INSUFFICIENT_CREDIT",

"failure_message":"Insufficient credit. This operation requires 'api' credits." } }

, look pulled from GET /v2/avatar_group/{id}/avatars):

{ "type":"avatar", "avatar_id":"<instant_avatar_look_id>", "voice_id":"<voice>",

"script":"…", "aspect_ratio":"9:16", "engine":{ "type":"avatar_v" } }

→ 200 { "data": { "status":"waiting", "video_id":"29160d4a8ebc42bea96cff569c8f2985" } }

GET /v3/videos/29160d4a8ebc42bea96cff569c8f2985

Same 'api' credits failure on both engines.

 So this is not an avatar-type / engine issue — it's the credit source.

┌────────────────────────────────────────────────────────┬─────────────────────────────────────────────────────────────────────┐

├────────────────────────────────────────────────────────┼─────────────────────────────────────────────────────────────────────┤

│ v2 POST /v2/video/generate, photo avatar │ render fails MOVIO_PAYMENT_INSUFFICIENT_CREDIT │

│ v3 type:"avatar" (Avatar IV), photo avatar │ 

, render fails requires 'api' credits │

│ v3 type:"avatar", stock avatar (e.g. Abigail) │ 400 "does not support Avatar IV video generation" │

│ v3 engine:{type:"avatar_v"}, photo avatar │ 400 "this photo avatar's group has no eligible instant avatar look" │

│ v3 engine:{type:"avatar_v"}, stock avatar │ 400 "does not support Avatar V video generation" │

│ 3 separate API keys (same account) │ identical on all │

└────────────────────────────────────────────────────────┴─────────────────────────────────────────────────────────────────────┘

Side note: POST /v3/videos type discriminator only accepts avatar, image, cinematic_avatar (cinematic_avatar requires a prompt, not a script). So the only path that accepts a custom script + my own

avatar is type:"avatar", which is the one failing on credits.

- 29160d4a8ebc42bea96cff569c8f2985 (Avatar V)

- b1fa7882cd34404cb6cfe88e3b2b09ea (Avatar V)

- ea319c9ce9ca41d3bc48c78abefb39f8 (Avatar IV)

- c999acc4e8314dcdb5fc9eafb6b26710 (Avatar IV)

 for the web-credits-through-API beta beyond receiving the invite? The dashboard shows the invite text, but remaining_quota is 0 and generations require api credits.

2. Does the beta require the API key to be 

 activation? (All my current keys may pre-date the entitlement.)

3. Should the v3 render draw from plan_credit (996) automatically, or is there a request field / header to select the credit source?

4. If Avatar V on v3 with an Instant Avatar is the supported path, what specifically still routes it to the api credit pool here?

Happy to provide the account email / org id privately. Thanks!


v3 API beta (web-subscription credits): every generation fails requires 'api' credits, remaining_quota: 0

Home

Forum

Events

Content

Collections

People

Contributors

Albums

Groups

Chat

Channels

Tools

Help

Connect with the community, find inspiration, and learn how to make your best videos. 

HeyGen

Dive deeper in the Geniverse. Learn, connect and level up with HeyGen.

HeyGen Community

Your Privacy Choices

It looks like there is no account associated with the email you provided. The event is for members only. Please complete the application to join our community first.

Thank you for your interest in joining us

Thanks for your interest in joining the event. However, your account is still pending. Once it's approved, you'll be able to register for the event. Please contact us via community@heygen.com if you need support.

Pending Approval

Login to the HeyGen community to connect with others, attend community events, and more!

Login or Sign Up for even more

To unlock all parts of the community and get the best experience, complete your profile.

Hey, complete your profile

It looks like there is no account associated with the email you provided. Please complete the application to join our community.

Thank you for your interest in joining HeyGen.

Thanks for your interest in joining HeyGen. We will review your request shortly and email you once it's approved. Meanwhile, please feel free to contact us via community@heygen.com for any questions.