BytePlus ModelArk

Use BytePlus ModelArk multimodal models in Dify via the Ark API.

Configure

Create an Ark API Key in BytePlus Console: https://console.byteplus.com/ark/
In Dify, go to Settings -> Model Provider -> BytePlus ModelArk.
Fill in the API Key and API Endpoint, then save.

Default endpoint:

https://ark.ap-southeast.bytepluses.com/api/v3

The BytePlus image API also documents the eu-west-1 endpoint:

https://ark.eu-west.bytepluses.com/api/v3

Models

Models are listed by Ark model id.
Supported multimodal IDs include seedream-5-0-260128, seedance-2-0-260128, and seedance-1-5-pro-251215.
If a model is visible in Dify but your Ark account has no access, the invocation will fail. Switch to a model you have enabled.

Multimodal Polling

Seedream image generation returns a terminal polling result from start.
Seedance video generation creates a task from start and checks task status from check.
Video task statuses queued and running keep polling; succeeded returns the generated video; failed, cancelled, and expired fail the invocation.
Generated image URLs are valid for about 24 hours.
Video tasks can be retrieved for about 7 days from creation.

Implementation Relationship

This package is an independent plugin so it can be registered and distributed separately from Volcengine. Its Ark multimodal polling logic intentionally mirrors the Volcengine plugin implementation; provider differences are isolated to the model IDs, default endpoint, platform name, and capability switches such as the absence of web_search.

Troubleshooting

401/403: invalid API key, or your account has no permission for the model.
404 / invalid URL: api_endpoint_host must include /api/v3.
Model not found: the model id is not enabled for your Ark account.
Timeout / connection error: ensure your Dify deployment can reach the configured Ark endpoint.