Seededit 3.0 教程--火山方舟大模型服务平台-火山引擎

文档中心

导航

Seededit 3.0 教程

最近更新时间：2025.09.15 15:09:35首次发布时间：2025.09.09 15:22:46

模型概述

SeedEdit 3.0是一款图像编辑模型，支持通过文本指令编辑图像。SeedEdit 3.0 基于文生图模型 Seedream 3.0 训练，叠加多样化的数据融合方法与特定奖励模型，其图像主体、背景和细节保持能力进一步提升，尤其在人像编辑、背景更改、视角与光线转换等场景表现突出。
通过这篇教程您可以学习到如何通过调用SeedEdit 3.0模型 API 来生成图片。

模型名称	版本	模型 ID（Model ID）	模型能力	限流 IPM 每分钟生成图片数量上限（张 / 分钟）	定价
doubao-seededit-3.0-i2i	250628`强烈推荐`	doubao-seededit-3-0-i2i-250628	图片编辑	500	图片生成模型

前提条件

您已有方舟 API Key，作为模型推理服务调用鉴权使用。如无，请参考1.获取 API Key。
在开通管理页开通所需模型的服务。
在模型列表获取所需模型的ID（Model ID），后续调用模型服务时需使用。

快速开始

您可以通过下面代码快速体验图像编辑能力。

import os
# 通过 pip install 'volcengine-python-sdk[ark]' 安装方舟SDK
# SDK 版本要求≥ 4.0.6，建议使用最新版 SDK，参考文档https://www.volcengine.com/docs/82379/1541595
from volcenginesdkarkruntime import Ark

# 请确保您已将 API Key 存储在环境变量 ARK_API_KEY 中
# 初始化Ark客户端，从环境变量中读取您的API Key
client = Ark(
    # 此为默认路径，您可根据业务所在地域进行配置
    base_url="https://ark.cn-beijing.volces.com/api/v3",
    # 从环境变量中获取您的 API Key。此为默认方式，您可根据需要进行修改
    api_key=os.environ.get("ARK_API_KEY"),
)

imagesResponse = client.images.generate(
    model="doubao-seededit-3-0-i2i-250628",
    prompt="改成爱心形状的泡泡",
    image="https://ark-project.tos-cn-beijing.volces.com/doc_image/seededit_i2i.jpeg",
    seed=123,
    guidance_scale=5.5,
    size="adaptive",
    watermark=True 
)

print(imagesResponse.data[0].url)

使用示例

图像编辑

根据您输入的文本描述和原始图片生成新的图片。

Python

Java

import os
# 通过 pip install 'volcengine-python-sdk[ark]' 安装方舟SDK
from volcenginesdkarkruntime import Ark

# 请确保您已将 API Key 存储在环境变量 ARK_API_KEY 中
# 初始化Ark客户端，从环境变量中读取您的API Key
client = Ark(
    # 此为默认路径，您可根据业务所在地域进行配置
    base_url="https://ark.cn-beijing.volces.com/api/v3",
    # 从环境变量中获取您的 API Key。此为默认方式，您可根据需要进行修改
    api_key=os.environ.get("ARK_API_KEY"),
)

imagesResponse = client.images.generate(
    model="doubao-seededit-3-0-i2i-250628",
    prompt="改成爱心形状的泡泡",
    image="https://ark-project.tos-cn-beijing.volces.com/doc_image/seededit_i2i.jpeg",
    seed=123,
    guidance_scale=5.5,
    size="adaptive",
    watermark=True 
)

print(imagesResponse.data[0].url)

package com.volcengine.ark.runtime;

import com.volcengine.ark.runtime.model.images.generation.GenerateImagesRequest;
import com.volcengine.ark.runtime.model.images.generation.ImagesResponse;
import com.volcengine.ark.runtime.model.images.generation.ResponseFormat;
import com.volcengine.ark.runtime.model.images.generation.Size;
import com.volcengine.ark.runtime.service.ArkService;
import okhttp3.ConnectionPool;
import okhttp3.Dispatcher;

import java.util.concurrent.TimeUnit;

public class ImageGenerationsExample { 
    public static void main(String[] args) {
        String apiKey = System.getenv("ARK_API_KEY");
        ConnectionPool connectionPool = new ConnectionPool(5, 1, TimeUnit.SECONDS);
        Dispatcher dispatcher = new Dispatcher();
        ArkService service = ArkService.builder().dispatcher(dispatcher).connectionPool(connectionPool).apiKey(apiKey).build();

        GenerateImagesRequest generateRequest = GenerateImagesRequest.builder()
                .model("doubao-seededit-3-0-i2i-250628")
                .prompt("改成爱心形状的泡泡")
                .image("https://ark-project.tos-cn-beijing.volces.com/doc_image/seededit_i2i.jpeg")
                .responseFormat(ResponseFormat.Url)
                .seed(123)
                .guidanceScale(5.5)
                .size(Size.Adaptive)
                .watermark(true)
                .build();

        ImagesResponse imagesResponse = service.generateImages(generateRequest);
        System.out.println(imagesResponse.getData().get(0).getUrl());

        service.shutdownExecutor();
    }
}

package main

import (
    "context"
    "fmt"
    "os"

    "github.com/volcengine/volcengine-go-sdk/service/arkruntime"
    "github.com/volcengine/volcengine-go-sdk/service/arkruntime/model"
    "github.com/volcengine/volcengine-go-sdk/volcengine"
)

func main() {
    client := arkruntime.NewClientWithApiKey(os.Getenv("ARK_API_KEY"))
    ctx := context.Background()

    generateReq := model.GenerateImagesRequest{
       Model:          "doubao-seededit-3-0-i2i-250628",
       Prompt:         "改成爱心形状的泡泡",
       Image:          volcengine.String("https://ark-project.tos-cn-beijing.volces.com/doc_image/seededit_i2i.jpeg"),
       ResponseFormat: volcengine.String(model.GenerateImagesResponseFormatURL),
       Seed:           volcengine.Int64(123),
       GuidanceScale:  volcengine.Float64(5.5),
       Size:           volcengine.String(model.GenerateImagesSizeAdaptive),
       Watermark:      volcengine.Bool(true),
    }

    imagesResponse, err := client.GenerateImages(ctx, generateReq)
    if err != nil {
       fmt.Printf("generate images error: %v\n", err)
       return
    }

    fmt.Printf("%s\n", *imagesResponse.Data[0].Url)
}

附录：应用场景

场景	描述
广告设计	快速生成多样化的广告素材，根据产品特点和目标受众，定制创意海报、宣传图片，节省设计时间与成本。
游戏开发	辅助创建游戏场景、角色形象和道具，通过输入关键词，生成高分辨率、风格统一的美术资源，加速游戏开发进程。
电商平台	为商品自动生成多角度、多场景展示图，模拟商品在不同环境下的使用效果，增强用户购物体验，提升商品吸引力。
教育领域	生成教学所需的插图、示意图，将抽象知识转化为可视化图像，辅助教师讲解复杂概念，帮助学生更好地理解知识。
影视制作	协助完成概念图绘制、特效场景设计，快速生成虚拟角色和奇幻场景的参考图，为影视创作提供灵感和视觉基础。