go-sora2api

go-sora2api

Sora 视频/图片生成 Go SDK，通过 TLS 指纹模拟绕过 Cloudflare 验证。

功能

• 文生图 / 图生图
• 文生视频 / 图生视频
• 视频 Remix（基于已有视频再创作）
• 获取去水印下载链接
• 10 种视频风格（anime、retro、comic 等）
• 提示词优化（AI 自动扩展提示词）
• 进度回调
• 代理支持

安装

go get github.com/DouDOU-start/go-sora2api/sora

快速开始

文生图

c, _ := sora.New("")
token, _ := c.GenerateSentinelToken(accessToken)
taskID, _ := c.CreateImageTask(accessToken, token, "a cute cat", 360, 360)
imageURL, _ := c.PollImageTask(accessToken, taskID, 3*time.Second, 600*time.Second, nil)

图生图

// 先上传图片
mediaID, _ := c.UploadImage(accessToken, imageData, "input.png")

// 基于图片生成新图片
token, _ := c.GenerateSentinelToken(accessToken)
taskID, _ := c.CreateImageTaskWithImage(accessToken, token, "make it more colorful", 360, 360, mediaID)
imageURL, _ := c.PollImageTask(accessToken, taskID, 3*time.Second, 600*time.Second, nil)

文生视频

token, _ := c.GenerateSentinelToken(accessToken)
taskID, _ := c.CreateVideoTask(accessToken, token, "a cat running", "landscape", 150, "sy_8", "small")
_ = c.PollVideoTask(accessToken, taskID, 3*time.Second, 600*time.Second, nil)
url, _ := c.GetDownloadURL(accessToken, taskID)

图生视频

mediaID, _ := c.UploadImage(accessToken, imageData, "input.png")

token, _ := c.GenerateSentinelToken(accessToken)
taskID, _ := c.CreateVideoTaskWithImage(accessToken, token, "animate this scene", "landscape", 150, "sy_8", "small", mediaID)
_ = c.PollVideoTask(accessToken, taskID, 3*time.Second, 600*time.Second, nil)
url, _ := c.GetDownloadURL(accessToken, taskID)

带风格的视频

// 方式一：通过参数指定风格
taskID, _ := c.CreateVideoTaskWithOptions(accessToken, token, "a cat running", "landscape", 150, "sy_8", "small", "", "anime")

// 方式二：从提示词中自动提取 {style}
prompt, styleID := sora.ExtractStyle("a cat running {anime}")
// prompt = "a cat running", styleID = "anime"

可选风格：festive, kakalaka, news, selfie, handheld, golden, anime, retro, nostalgic, comic

Remix 视频

// 从分享链接提取视频 ID
remixID := sora.ExtractRemixID("https://sora.chatgpt.com/p/s_690d100857248191b679e6de12db840e")

token, _ := c.GenerateSentinelToken(accessToken)
taskID, _ := c.RemixVideo(accessToken, token, remixID, "make it snowy", "landscape", 150, "")
_ = c.PollVideoTask(accessToken, taskID, 3*time.Second, 600*time.Second, nil)
url, _ := c.GetDownloadURL(accessToken, taskID)

获取去水印下载链接

注意：此功能需要 refresh_token，不支持普通的 ChatGPT access_token。

c, _ := sora.New("")

// 1. 使用 refresh_token 刷新获取专用 access_token
soraToken, newRefreshToken, _ := c.RefreshAccessToken(refreshToken, "")
// newRefreshToken 已更新，需保存供下次使用

// 2. 获取去水印链接（支持传入完整链接或视频 ID）
url, _ := c.GetWatermarkFreeURL(soraToken, "https://sora.chatgpt.com/p/s_xxx")
// 或
url, _ := c.GetWatermarkFreeURL(soraToken, "s_xxx")

提示词优化

enhanced, _ := c.EnhancePrompt(accessToken, "a cat", "medium", 10)
// enhanced = "A playful orange tabby cat sits gracefully..."

进度回调

c.PollImageTask(accessToken, taskID, 3*time.Second, 600*time.Second, func(p sora.Progress) {
    fmt.Printf("\r进度: %d%% 状态: %s 耗时: %ds", p.Percent, p.Status, p.Elapsed)
})

代理支持

c, _ := sora.New("http://user:pass@ip:port")
c, _ := sora.New("socks5://user:pass@ip:port")

// ParseProxy 解析简写格式
proxy := sora.ParseProxy("ip:port:user:pass")
c, _ := sora.New(proxy)

API 参考

视频参数

图片参数

CLI 工具

提供交互式命令行工具，支持全部功能：

go install github.com/DouDOU-start/go-sora2api/cmd/sora2api@latest
sora2api

或编译后运行：

go build -o sora2api ./cmd/sora2api/
./sora2api

项目结构

go-sora2api/
├── sora/                    # 公开 SDK 包
│   ├── client.go            # 客户端基础 + Sentinel Token
│   ├── task.go              # 任务创建（Upload/Image/Video/Remix/Enhance）
│   ├── poll.go              # 任务轮询 + 下载链接
│   ├── style.go             # 风格提取 + Remix ID 解析
│   ├── pow.go               # PoW (SHA3-512) 算法
│   └── util.go              # 代理解析等工具
├── cmd/sora2api/
│   └── main.go              # 交互式 CLI 工具
├── go.mod
└── README.md

免责声明

本项目仅供学习和研究使用，不得用于任何商业或非法用途。使用者应自行承担使用本项目所产生的一切风险和责任，项目作者不对因使用本项目而导致的任何直接或间接损失承担责任。

使用本项目即表示您已阅读并同意以上声明。

许可证

MIT License