构建 AI 头像创作体验
将图像生成能力接入头像创作功能。为用户提供清晰的输入流程、异步进度、结果选择与内容管理。
多种艺术风格
可通过提示词生成写实、动漫、奇幻、赛博朋克等不同风格。
方形与人像画幅
头像常见比例为 1:1，也可使用 3:4 或 2:3 人像构图。
异步交付
提交提示词后，任务完成时通过 Webhook 接收图像 URL。
头像风格与用户体验
可以围绕插画、奇幻、职业形象或社群风格设计提示词模板。风格示例仅用于说明创意方向，实际生成效果会随提示词、模型能力及服务参数变化。
向用户说明任务为异步处理，并在等待期间展示进度；生成多个候选结果时，提供预览、选择和删除等管理选项。
集成示例流程
- 用户选择风格并提交必要提示词。
- 服务端检查权限、输入和额度。
- 提交图像任务，并把任务 ID 与用户记录关联。
- 通过 Webhook 或查询状态加载完成结果。
- 应用执行必要的审核与访问控制后展示头像。
谁会使用头像 API
社区与社交产品可为用户提供个性化形象；创意工具可让用户探索不同视觉方案；游戏与活动产品也可将头像创作纳入用户参与流程。上线前应评估用户生成内容审核、隐私和数据保留要求。
隐私与安全
只收集完成功能所需的数据，避免在提示词或日志中保留不必要的个人信息。允许用户管理或删除生成结果，并根据适用政策处理不当内容。
常见问题
头像生成适合采用异步任务与状态通知。请将服务密钥保存在服务端，为用户设置合理使用限制，并在公开展示前执行适用的安全检查。
常见头像风格与提示词
- 职业头像：professional linkedin headshot, soft studio lighting, neutral background, sharp focus, photorealistic --ar 1:1。
- 动漫肖像：anime portrait, vibrant colors, detailed eyes, manga style, clean lines --ar 1:1 --niji 6。
- 奇幻战士：fantasy warrior portrait, dramatic lighting, intricate armor, epic art style --ar 1:1。
- 扁平矢量：flat vector portrait illustration, minimal colors, geometric shapes, clean modern design。
- 赛博朋克：cyberpunk character portrait, neon lights, futuristic outfit, digital art。
- 古典油画：classical oil painting portrait, renaissance style, rich colors, fine brushwork --ar 3:4。
集成流程
用户选择风格后，服务端把提示词发送到 /v1/submit-jobs，并提供 Webhook URL。收到 taskId 后保存 userId 与 taskId 的映射；回调状态完成时更新用户头像并通知用户。
// 用户请求生成动漫风格头像
async function generateAvatar(userId, prompt) {
const response = await fetch(
'https://api.midjourney-api.com/v1/submit-jobs',
{
method: 'POST',
headers: { 'Authorization': 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json' },
body: JSON.stringify({ prompt, webhookUrl: 'https://your-app.com/webhook/avatar/' + userId }),
}
);
const { taskId } = await response.json();
await db.pendingAvatars.insert({ userId, taskId });
}哪些产品适合接入头像 API
- 社交平台：用户按偏好生成动漫、职业或奇幻风格头像。
- 游戏应用：生成角色肖像、公会头像和游戏档案图片。
- 专业工具：为 HR 软件、职业社交工具或简历产品提供专业头像。
- 创意平台：生成作者肖像、品牌吉祥物和身份视觉。
头像生成常见尺寸
个人资料头像最常用方形 --ar 1:1；角色插画或全身图可考虑 --ar 3:4 或 --ar 2:3。实际尺寸和裁切方式应与应用展示区域相匹配。
常见问题
可以通过 API 批量生成头像吗？
可以。可并行提交多个头像任务，并通过 Webhook 接收结果。原页面给出的并发数最多为 10，实际限制以账户规则为准。
可以生成哪些头像风格？
可通过提示词描述写实职业照、动漫/漫画、奇幻、像素风、油画肖像等多种风格。风格主要由提示词控制，动漫可使用 Niji 选项。
头像应该使用什么画幅？
头像和个人资料图片通常使用 --ar 1:1；角色艺术或全身像也可使用 --ar 3:4 或 --ar 2:3。
如何将头像 API 集成到现有应用？
向 /v1/submit-jobs 提交用户头像提示词，保存返回的 taskId，并在生成完成时通过 Webhook 获取图像 URL。