aliyun

Documentation

Overview

Package aliyun 对接阿里云百炼（DashScope）多模态 API。

对外入口为本目录下的 Config、Engine、New 与模型常量；实现按能力域拆在 internal 子包中（仅 aliyun 可导入）：

• internal/imggen 图片生成（qwen-image 文生图、Wan/z-image 多模态图）
• internal/vidgen 视频生成与编辑（Wan t2v / r2v / videoedit）
• internal/audiogen 语音合成与声音设计（Qwen TTS、qwen-voice-design）
• internal/async 异步任务创建与轮询
• internal/graphx 从 workflow.Graph 抽取各域共用字段
• internal/runtime HTTP 与轮询等运行时参数
• internal/ierr 错误哨兵（根包重新导出以保持 API 稳定）

Index

• Constants
• Variables
• func ConfigSchema() []engine.ConfigField
• func ModelsByCapability() map[string][]string
• type Config
• type Engine
  • func New(cfg Config) *Engine
  • func (e *Engine) Capabilities() engine.Capability
  • func (e *Engine) Execute(ctx context.Context, graph workflow.Graph) (engine.Result, error)
  • func (e *Engine) Resume(ctx context.Context, remoteID string) (engine.Result, error)

Constants

const (
	ModelQwenImage         = "qwen-image"
	ModelQwenImage2        = "qwen-image-2.0"
	ModelQwenImageEditPlus = "qwen-image-edit-plus"
	ModelWanImage          = "wan2.7-image"
	ModelZImageTurbo       = "z-image-turbo"
	ModelWanTextToVideo    = "wan2.7-t2v"
	ModelWanImageToVideo   = "wan2.7-i2v"
	ModelWanReferenceVideo = "wan2.7-r2v"
	ModelWanVideoEdit      = "wan2.7-videoedit"

	ModelKlingV3Video     = "kling/kling-v3-video-generation"
	ModelKlingV3OmniVideo = "kling/kling-v3-omni-video-generation"

	ModelQwenTTSFlash         = "qwen3-tts-flash"
	ModelQwenTTSInstructFlash = "qwen3-tts-instruct-flash"
	ModelQwenVoiceDesign      = "qwen-voice-design"

	ModelQwenASRFlash          = "qwen3-asr-flash"
	ModelQwenASRFlashFiletrans = "qwen3-asr-flash-filetrans"
)

Variables

var (
	ErrMissingPrompt      = ierr.ErrMissingPrompt
	ErrMissingReference   = ierr.ErrMissingReference
	ErrMissingVoice       = ierr.ErrMissingVoice
	ErrMissingVoiceDesign = ierr.ErrMissingVoiceDesign
	ErrMissingAudioURL    = ierr.ErrMissingAudioURL
	ErrMissingAPIKey      = ierr.ErrMissingAPIKey
	ErrUnsupportedModel   = ierr.ErrUnsupportedModel
)

与 internal/ierr 中哨兵为同一指针，便于 errors.Is。

Functions

func ConfigSchema

func ConfigSchema() []engine.ConfigField

ConfigSchema returns the configuration fields required by the Aliyun engine.

func ModelsByCapability

func ModelsByCapability() map[string][]string

ModelsByCapability returns all supported models grouped by capability key (e.g. "image", "image_edit", "video", "tts"). This allows consumers to auto-discover models without hardcoding.

Types

type Config

type Config struct {
	APIKey            string
	BaseURL           string
	Model             string
	HTTPClient        *http.Client
	WaitForCompletion bool
	PollInterval      time.Duration
}

Config configures the Alibaba Cloud Bailian engine.

type Engine

type Engine struct {
	// contains filtered or unexported fields
}

Engine compiles a workflow graph into a Bailian backend request.

func New

func New(cfg Config) *Engine

New creates a Bailian execution engine.

func (*Engine) Capabilities

func (e *Engine) Capabilities() engine.Capability

Capabilities implements engine.Describer.

func (*Engine) Execute

func (e *Engine) Execute(ctx context.Context, graph workflow.Graph) (engine.Result, error)

Execute compiles the workflow graph into the configured Bailian model request.

func (*Engine) Resume

func (e *Engine) Resume(ctx context.Context, remoteID string) (engine.Result, error)

Resume implements engine.Resumer — resumes polling a previously submitted task.