Skip to content

Formerly KrillinAI, VideoTranslation and Dubbing Tool for 120+ Languages. Open-source AI workspace for creators, powered by Codex. Video downloader, video translation, create videos, images, audios, and edits with Agents in one place. For your Social Media like YouTube, TikTok, Instagram, etc.

Merge PR #327: add Codex-native YouTube Shorts pipeline

Leggettaf80923a05f2
diff --cc apps/daemon/src/api/server.ts
index e0d90dbc,1df75a6d..fb6b5e0c
--- a/apps/daemon/src/api/server.ts
+++ b/apps/daemon/src/api/server.ts
@@@ -43,6 -43,6 +43,10 @@@ import { createKrillinExecutor } from '
import { createKrillinDependencyLoader } from '../creator/krillin/dependency-loader.js';
import { readKrillinRuntimeManifest, resolveInside, verifyKrillinRuntimeManifest } from '../creator/krillin/manifest.js';
import { createKrillinTtsService } from '../creator/krillin/tts-service.js';
++import {
++ createKrillinCodexLlmGateway,
++ KRILLIN_LLM_ROUTE_PREFIX
++} from '../creator/krillin/codex-llm-gateway.js';
import { createDownloadExecutor } from '../creator/download/executor.js';
import { resolveYtDlpRuntime } from '../creator/yt-dlp/runtime.js';
import {
@@@ -80,6 -80,6 +84,7 @@@ import { createStickmanDeliveryExecuto
import { CreatorProviderRequestLedger } from '../creator/provider-requests.js';
import { createCreatorProjectCoverService } from '../creator/project-cover.js';
import { createVideoGenerationService } from '../video-generation/service.js';
++import { createImageGenerationService } from '../image-generation/service.js';
import {
createCreatorReferenceImageUploadService,
type CreatorReferenceImageUploadService
@@@ -145,6 -144,6 +150,7 @@@ import
isCodexCredentialStoreConfigurationDiagnostic
} from '../codex/credential-storage.js';
import { resolveCodexHome } from '../codex/home.js';
++import { createCodexIsolatedHome } from '../codex/probe-home.js';
import {
createCodexModelCatalog,
type CodexModelCatalog
@@@ -221,6 -220,6 +227,7 @@@ import { registerCreatorServicesRoutes
import { registerCreatorRoutes } from './routes.creator.js';
import { registerCreatorRuntimeRoutes } from './routes.creator-runtime.js';
import { registerDiagnosticsRoutes } from './routes.diagnostics.js';
++import { registerImageGenerationRoutes } from './routes.image-generation.js';
import { registerMcpRoutes } from './routes.mcp.js';
import { registerMemoryRoutes } from './routes.memory.js';
import { registerNotificationRoutes } from './routes.notifications.js';
@@@ -249,6 -248,6 +256,7 @@@ export type BuildServerInput =
db?: Database.Database;
codexBin?: string;
codexHome?: string;
++ localCodexHome?: string;
defaultCwd?: string;
defaultProjectRoot?: string;
runManager?: RunManager;
@@@ -325,6 -324,6 +333,14 @@@ export async function buildServer(input
? resolveCodexHome()
: resolveCodexHome({ isolatedHome: input.codexHome });
const codexHome = resolvedCodexHome.path;
++ const localCodexHome = resolve(input.localCodexHome ?? codexHome);
++ if (
++ input.localCodexHome !== undefined
++ && resolvedCodexHome.mode === 'isolated'
++ && localCodexHome !== codexHome
++ ) {
++ createCodexIsolatedHome(localCodexHome, codexHome);
++ }
try {
await ensureCodexFileCredentialStore(codexHome);
} catch (error) {
@@@ -472,8 -471,8 +488,13 @@@
const runtimeTransport = input.runtimeTransport ?? 'app-server';
const getAgentToolBaseUrl = () =>
resolveListeningOrigin(server.server.address());
++ const krillinCodexLlmGateway = createKrillinCodexLlmGateway({
++ codexBin,
++ codexHome,
++ cwd: dataDir
++ });
const creatorAgentBootstrapInput = {
-- sourceCodexHome: codexHome,
++ sourceCodexHome: localCodexHome,
runtimeRoot: runtimeDir,
...(input.appHome === undefined
? {}
@@@ -586,6 -585,6 +607,11 @@@
dataDir,
configStore: creatorServicesConfigStore
});
++ const imageGenerationService = createImageGenerationService({
++ dataDir,
++ configStore: creatorServicesConfigStore,
++ codexNative: { codexHome }
++ });
const developmentStickmanRuntimeRoot = resolve(
dirname(fileURLToPath(import.meta.url)),
'../../../desktop/.pack/stickman-runtime'
@@@ -635,6 -634,7 +661,7 @@@
creatorExecutors.push(createStickmanImageExecutor({
configStore: creatorServicesConfigStore,
ledger: creatorProviderRequestLedger,
- codexNative: { codexBin, codexHome, cwd: defaultCwd },
++ codexNative: { codexHome },
...(creatorTesseractPath === undefined ? {} : { tesseractPath: creatorTesseractPath })
}));
}
@@@ -694,7 -693,7 +721,11 @@@
jobsRoot: creatorJobsRoot,
dependencyLoader: krillinDependencyLoader,
configStore: creatorServicesConfigStore,
-- getYtDlpRuntime
++ getYtDlpRuntime,
++ getCodexLlmConfig() {
++ const baseUrl = resolveListeningOrigin(server.server.address());
++ return baseUrl === undefined ? undefined : krillinCodexLlmGateway.config(baseUrl);
++ }
}));
}
if (
@@@ -766,6 -765,7 +797,7 @@@
}));
creatorExecutors.push(createImageExecutor({
configStore: creatorServicesConfigStore,
- codexNative: { codexBin, codexHome, cwd: defaultCwd },
++ codexNative: { codexHome },
...(creatorFfmpegPath === undefined
? {}
: {
@@@ -786,21 -786,12 +818,24 @@@
getYtDlpRuntime: getCreatorYtDlpRuntime
}),
model: createWechatArticleModel({ configStore: creatorServicesConfigStore }),
- imageGenerator: createArticleImageGenerator({ configStore: creatorServicesConfigStore })
+ imageGenerator: createArticleImageGenerator({
+ configStore: creatorServicesConfigStore,
- codexNative: { codexBin, codexHome, cwd: defaultCwd }
++ codexNative: { codexHome }
+ })
}));
}
+ const creatorPreflight = createCreatorPreflight({
+ configStore: creatorServicesConfigStore,
+ readCapabilities: () => krillinDependencyLoader.capabilities(),
+ resourceRoot: creatorRuntimeRoot,
+ jobsRoot: creatorJobsRoot,
+ ffmpegPath: creatorFfmpegPath,
+ ffprobePath: creatorFfprobePath,
+ stickmanRuntimeRoot,
+ ...(getYtDlpRuntime === undefined ? {} : { getYtDlpRuntime }),
+ executorIds: creatorExecutors.map(executor => executor.id),
+ validateRuntimeAssets: input.creatorExecutors === undefined
+ });
const creatorProjectCoverService = createCreatorProjectCoverService({
jobsRoot: creatorJobsRoot,
...(creatorFfmpegPath === undefined ? {} : { ffmpegPath: creatorFfmpegPath })
@@@ -1172,6 -1162,6 +1207,7 @@@
await capture(() => appServerRuntimeManager?.close());
await capture(() => creatorAppServerRuntimeManager?.close());
await capture(() => stickmanContentRuntimeManager?.close());
++ await capture(() => krillinCodexLlmGateway.close());
await capture(() => codexSessionProvider.close());
await capture(() => codexModelCatalog.close());
await capture(() => codexControlClient.close());
@@@ -1191,6 -1181,6 +1227,7 @@@
server.addHook('preHandler', async (request, reply) => {
if (request.url === '/healthz') return;
if (isAgentToolInternalRequest(request.url)) return;
++ if (request.url.startsWith(`${KRILLIN_LLM_ROUTE_PREFIX}/`)) return;
await auth(request, reply);
});
@@@ -1235,6 -1225,6 +1272,7 @@@
contextBuilder: creatorAgentContextBuilder
})
});
++ await krillinCodexLlmGateway.register(server);
if (input.agentToolsEnabled === true) {
await registerAgentScheduleMcpRoute(server, {
capabilities: agentCapabilityTokens,
@@@ -1260,6 -1250,6 +1298,7 @@@
);
await registerSmartDubbingRoutes(server, smartDubbingService);
await registerCreatorRuntimeRoutes(server, creatorYtDlpUpdateManager);
++ await registerImageGenerationRoutes(server, imageGenerationService);
await registerCreatorRoutes(server, creatorService, creatorEvents, {
sseHeartbeatMs: input.sseHeartbeatMs,
jobsRoot: creatorJobsRoot,
diff --cc apps/daemon/src/codex/local-provider.ts
index 00000000,00000000..d4ae3944
new file mode 100644
--- /dev/null
+++ b/apps/daemon/src/codex/local-provider.ts
@@@ -1,0 -1,0 +1,95 @@@
++import { parse } from '@iarna/toml';
++import { readFile } from 'node:fs/promises';
++import { join } from 'node:path';
++
++type TomlValue = ReturnType<typeof parse>[string];
++
++export type LocalCodexProvider = {
++ baseUrl: string;
++ apiKey: string;
++ model: string;
++};
++
++export class LocalCodexProviderError extends Error {
++ constructor(message: string) {
++ super(message);
++ this.name = 'LocalCodexProviderError';
++ }
++}
++
++export async function readLocalCodexProvider(input: {
++ codexHome: string;
++ env?: NodeJS.ProcessEnv;
++}): Promise<LocalCodexProvider> {
++ const env = input.env ?? process.env;
++ const config = await readToml(join(input.codexHome, 'config.toml'));
++ const providerId = readString(config.model_provider);
++ const providers = readRecord(config.model_providers);
++ const provider = providerId.length === 0
++ ? undefined
++ : readRecord(providers?.[providerId]);
++ const baseUrl = readString(provider?.base_url) || readString(config.openai_base_url);
++ const model = readString(config.model);
++ const providerToken = readString(provider?.experimental_bearer_token);
++ const envKey = readString(provider?.env_key);
++ const envToken = envKey.length === 0 ? '' : (env[envKey]?.trim() ?? '');
++ const auth = await readJson(join(input.codexHome, 'auth.json'));
++ const authToken = readString(auth?.OPENAI_API_KEY);
++ const apiKey = providerToken || envToken || authToken;
++
++ if (!baseUrl) {
++ throw new LocalCodexProviderError('本机 Codex 未配置可用于生图的 Base URL');
++ }
++ if (!apiKey) {
++ throw new LocalCodexProviderError(
++ '本机 Codex 当前只有 ChatGPT 登录态,未配置图像接口可用的 API Key'
++ );
++ }
++ return {
++ baseUrl,
++ apiKey,
++ model: imageModel(model)
++ };
++}
++
++async function readToml(path: string): Promise<Record<string, TomlValue>> {
++ try {
++ return parse(await readFile(path, 'utf8'));
++ } catch (error) {
++ if (isNotFound(error)) {
++ throw new LocalCodexProviderError('未找到本机 Codex 配置');
++ }
++ throw new LocalCodexProviderError('无法读取本机 Codex 配置');
++ }
++}
++
++async function readJson(path: string): Promise<Record<string, unknown> | undefined> {
++ try {
++ const value = JSON.parse(await readFile(path, 'utf8')) as unknown;
++ return readRecord(value);
++ } catch (error) {
++ if (isNotFound(error)) return undefined;
++ return undefined;
++ }
++}
++
++function imageModel(textModel: string): string {
++ return /^gpt-image-/i.test(textModel) ? textModel : 'gpt-image-1';
++}
++
++function readRecord(value: unknown): Record<string, TomlValue> | undefined {
++ return typeof value === 'object' && value !== null && !Array.isArray(value)
++ ? value as Record<string, TomlValue>
++ : undefined;
++}
++
++function readString(value: unknown): string {
++ return typeof value === 'string' ? value.trim() : '';
++}
++
++function isNotFound(error: unknown): boolean {
++ return typeof error === 'object'
++ && error !== null
++ && 'code' in error
++ && error.code === 'ENOENT';
++}
diff --cc apps/daemon/src/codex/provider-config.ts
index 17ded442,17ded442..926d6f86
--- a/apps/daemon/src/codex/provider-config.ts
+++ b/apps/daemon/src/codex/provider-config.ts
@@@ -144,13 -144,13 +144,18 @@@ function presentProviderConfig
state: Awaited<ReturnType<typeof readProviderState>>,
storedApiKeyConfigured: boolean
): CodexProviderConfig {
++ const apiKeyConfigured = state.providerCredentialConfigured || (
++ state.baseUrl.length > 0
++ ? storedApiKeyConfigured
++ : state.authentication === 'api_key' || storedApiKeyConfigured
++ );
return {
baseUrl: state.baseUrl,
model: state.model,
-- apiKeyConfigured: state.baseUrl.length > 0
-- ? storedApiKeyConfigured
-- : state.authentication === 'api_key' || storedApiKeyConfigured,
-- authentication: state.authentication,
++ apiKeyConfigured,
++ authentication: state.authentication === 'none' && state.providerCredentialConfigured
++ ? 'api_key'
++ : state.authentication,
...(state.configVersion === undefined ? {} : { configVersion: state.configVersion })
};
}
@@@ -175,6 -175,6 +180,7 @@@ async function readProviderState(client
model: string;
modelProvider: string;
authentication: CodexProviderAuthentication;
++ providerCredentialConfigured: boolean;
configVersion?: string;
}> {
const [configResponse, accountResponse] = await Promise.all([
@@@ -194,10 -194,10 +200,17 @@@
model: readString(config, 'model'),
modelProvider,
authentication: authenticationOf(accountResponse),
++ providerCredentialConfigured: providerCredentialConfigured(configuredProvider),
...(configVersion === undefined ? {} : { configVersion })
};
}
++function providerCredentialConfigured(provider: Record<string, unknown> | undefined): boolean {
++ if (readString(provider, 'experimental_bearer_token').length > 0) return true;
++ const envKey = readString(provider, 'env_key');
++ return envKey.length > 0 && (process.env[envKey]?.trim().length ?? 0) > 0;
++}
++
function normalizeUpdateRequest(request: CodexProviderConfigUpdateRequest): {
baseUrl: string;
model: string;
diff --cc apps/daemon/src/creator/article/image-generator.ts
index 95836036,b743ae09..f53afb76
--- a/apps/daemon/src/creator/article/image-generator.ts
+++ b/apps/daemon/src/creator/article/image-generator.ts
@@@ -3,9 -3,10 +3,11 @@@ import type { CreatorServicesConfigStor
import {
generateImageContents,
ImageGenerationProviderError,
- type GeneratedImageContent
+ type GeneratedImageContent,
+ type CodexNativeImageRuntime
} from '../../image-generation/provider.js';
import { CreatorExecutorError } from '../executor.js';
++import { resolveCreatorImageSettings } from '../image-settings.js';
export type ArticleImageGenerationResult = GeneratedImageContent & {
provider: ImageGenerationProvider;
@@@ -21,9 -23,10 +24,14 @@@ export function createArticleImageGener
async generate(request: {
prompt: string;
signal: AbortSignal;
+ cwd?: string;
}): Promise<ArticleImageGenerationResult> {
const config = await input.configStore.read();
-- const provider = config.image.provider;
++ const { provider } = resolveCreatorImageSettings({
++ config,
++ fallbackCandidateCount: 1,
++ maxCandidateCount: 1
++ });
try {
const result = await generate({
prompt: request.prompt,
@@@ -31,7 -34,12 +39,12 @@@
size: '1536x1024',
quality: 'medium',
count: 1
- }, config, { signal: request.signal });
+ }, config, {
+ signal: request.signal,
+ ...(input.codexNative === undefined
+ ? {}
- : { codexNative: { ...input.codexNative, ...(request.cwd === undefined ? {} : { cwd: request.cwd }) } })
++ : { codexNative: input.codexNative })
+ });
const image = result.contents[0];
if (image === undefined) {
throw new ImageGenerationProviderError('upstream_error', 'The image provider returned no image');
diff --cc apps/daemon/src/creator/image-settings.ts
index 00000000,00000000..3aadd62f
new file mode 100644
--- /dev/null
+++ b/apps/daemon/src/creator/image-settings.ts
@@@ -1,0 -1,0 +1,69 @@@
++import type {
++ CreatorServicesConfig,
++ ImageGenerationProvider
++} from '@opencreator/protocol';
++import { imageGenerationCapabilities } from '../image-generation/provider.js';
++
++export type ResolvedCreatorImageSettings = {
++ provider: ImageGenerationProvider;
++ model: string;
++ candidateCount: number;
++ supportsReferenceImage: boolean;
++ maxReferenceImages: number;
++ executionMode: 'local' | 'remote';
++};
++
++export function resolveCreatorImageSettings(input: {
++ config: CreatorServicesConfig;
++ provider?: unknown;
++ candidateCount?: unknown;
++ fallbackCandidateCount: number;
++ maxCandidateCount: number;
++}): ResolvedCreatorImageSettings {
++ const provider = readImageProvider(input.provider, input.config.image.provider);
++ const capabilities = imageGenerationCapabilities(provider);
++ const requestedCount = typeof input.candidateCount === 'number'
++ ? Math.floor(input.candidateCount)
++ : input.fallbackCandidateCount;
++ const candidateCount = provider === 'codex-native'
++ ? 1
++ : Math.min(input.maxCandidateCount, Math.max(1, requestedCount));
++ return {
++ provider,
++ model: provider === 'codex-native' ? 'codex-native' : input.config.image[provider].model,
++ candidateCount,
++ supportsReferenceImage: capabilities.supportsReferenceImage,
++ maxReferenceImages: capabilities.maxReferenceImages,
++ executionMode: provider === 'codex-native' ? 'local' : 'remote'
++ };
++}
++
++export function imageProviderConfigured(
++ config: CreatorServicesConfig,
++ provider: ImageGenerationProvider
++): boolean {
++ if (provider === 'codex-native') return true;
++ if (provider === 'kling') {
++ const settings = config.image.kling;
++ return settings.baseUrl.trim().length > 0
++ && settings.model.trim().length > 0
++ && settings.accessKey.trim().length > 0
++ && settings.secretKey.trim().length > 0;
++ }
++ const settings = config.image[provider];
++ if (!settings.baseUrl.trim() || !settings.model.trim()) return false;
++ return settings.apiKey.trim().length > 0;
++}
++
++export function readImageProvider(
++ value: unknown,
++ fallback: ImageGenerationProvider
++): ImageGenerationProvider {
++ return value === 'openai'
++ || value === 'jimeng'
++ || value === 'kling'
++ || value === 'gemini'
++ || value === 'codex-native'
++ ? value
++ : fallback;
++}
diff --cc apps/daemon/src/creator/image/executor.ts
index 5a7da81b,d7043517..7b28d722
--- a/apps/daemon/src/creator/image/executor.ts
+++ b/apps/daemon/src/creator/image/executor.ts
@@@ -2,8 -2,8 +2,6 @@@ import type
CoverStyleId,
CoverTextLanguage,
CreateImageGenerationRequest,
-- CreatorServicesConfig,
-- ImageGenerationProvider,
ImageGenerationQuality,
ImageGenerationSize
} from '@opencreator/protocol';
@@@ -18,6 -19,6 +17,7 @@@ import type { CreatorExecutor, CreatorE
import { CreatorExecutorError } from '../executor.js';
import { spawnCreatorProcess } from '../process-tree.js';
import { validateImageFile } from '../validators/image.js';
++import { resolveCreatorImageSettings } from '../image-settings.js';
import {
coverLanguageLabel,
coverStyleInstructions,
@@@ -111,7 -119,10 +118,10 @@@ export function createImageExecutor(inp
content: referenceImage.content,
mime: referenceImage.mime
}
- })
+ }),
+ ...(input.codexNative === undefined
+ ? {}
- : { codexNative: { ...input.codexNative, cwd: stage.workdir } })
++ : { codexNative: input.codexNative })
}
)
.then(async result => {
@@@ -273,29 -284,29 +283,32 @@@ export function createFfmpegCoverImageN
function imageRequest(
stage: CreatorExecutorInput,
-- config: CreatorServicesConfig,
++ config: Awaited<ReturnType<CreatorServicesConfigStore['read']>>,
referenceKind?: GenerationReferenceKind
): ImageRequestContext {
-- const provider = readProvider(stage.job.state.provider, config.image.provider);
++ const maxCount = stage.job.templateId === 'image-generation' ? 4 : 8;
++ const fallbackCount = stage.job.templateId === 'image-generation' ? 2 : 3;
++ const settings = resolveCreatorImageSettings({
++ config,
++ provider: stage.job.state.provider,
++ candidateCount: stage.job.state.candidateCount,
++ fallbackCandidateCount: fallbackCount,
++ maxCandidateCount: maxCount
++ });
const size = stage.job.templateId === 'image-generation'
? readImageSize(stage.job.state.size)
: sizeForCoverRatio(readCoverRatio(stage));
const quality = readQuality(stage.job.state.quality);
-- const maxCount = stage.job.templateId === 'image-generation' ? 4 : 8;
-- const fallbackCount = stage.job.templateId === 'image-generation' ? 2 : 3;
-- const candidateCount = typeof stage.job.state.candidateCount === 'number'
-- ? Math.min(maxCount, Math.max(1, Math.floor(stage.job.state.candidateCount)))
-- : fallbackCount;
const cover = stage.job.templateId === 'cover'
? coverGenerationPrompt(stage, referenceKind)
: undefined;
return {
request: {
prompt: cover?.prompt ?? readString(stage.job.state.prompt),
-- provider,
++ provider: settings.provider,
size,
quality,
-- count: candidateCount
++ count: settings.candidateCount
},
...(cover === undefined ? {} : { cover: cover.details })
};
@@@ -419,15 -430,19 +432,6 @@@ async function readReferenceImage
};
}
--function readProvider(
-- value: unknown,
-- fallback: CreatorServicesConfig['image']['provider']
--): ImageGenerationProvider {
- return value === 'openai' || value === 'jimeng' || value === 'kling' || value === 'gemini'
- return value === 'openai'
- || value === 'jimeng'
- || value === 'kling'
- || value === 'gemini'
- || value === 'codex-native'
-- ? value
-- : fallback;
--}
--
function readString(value: unknown): string {
return typeof value === 'string' ? value.trim() : '';
}
diff --cc apps/daemon/src/creator/krillin/adapter.ts
index 4cce580d,4cce580d..f706ba84
--- a/apps/daemon/src/creator/krillin/adapter.ts
+++ b/apps/daemon/src/creator/krillin/adapter.ts
@@@ -34,6 -34,6 +34,7 @@@ export function createKrillinExecutor(i
dependencyLoader: KrillinDependencyLoader;
configStore: Pick<CreatorServicesConfigStore, 'read'>;
getYtDlpRuntime?(): YtDlpRuntime | undefined;
++ getCodexLlmConfig?(): { baseUrl: string; apiKey: string; model: string } | undefined;
}): CreatorExecutor {
return {
id: 'krillinai',
@@@ -74,7 -74,7 +75,10 @@@
artifacts: materializedArtifacts,
source: attempt.source,
options: attempt.options,
-- ytDlpRuntime: input.getYtDlpRuntime?.()
++ ytDlpRuntime: input.getYtDlpRuntime?.(),
++ llmOverride: preflight.config.llm.source === 'codex'
++ ? input.getCodexLlmConfig?.()
++ : undefined
});
break;
} catch (error) {
diff --cc apps/daemon/src/creator/krillin/cli-runner.ts
index d5a5f83b,d2562c88..ec0b9add
--- a/apps/daemon/src/creator/krillin/cli-runner.ts
+++ b/apps/daemon/src/creator/krillin/cli-runner.ts
@@@ -82,6 -82,6 +82,7 @@@ type RunKrillinCliInput =
source?: string;
options: Record<string, unknown>;
ytDlpRuntime?: YtDlpRuntime;
++ llmOverride?: { baseUrl: string; apiKey: string; model: string };
};
export async function runKrillinCli(input: RunKrillinCliInput): Promise<KrillinResultArtifact[]> {
@@@ -112,7 -112,7 +113,7 @@@
const cliConfig = stageConfig(input.config, krillinCliStageId(input.stage.stageRun.stageId), input.options);
await writeFile(
join(configDir, 'config.toml'),
-- createKrillinConfigToml(cliConfig),
++ createKrillinConfigToml(cliConfig, input.llmOverride),
{ mode: 0o600 }
);
await writeFile(join(dependencyBin, '.yt-dlp-last-check'), new Date().toISOString(), { mode: 0o600 });
diff --cc apps/daemon/src/creator/krillin/codex-llm-gateway.ts
index 00000000,00000000..c3bbd879
new file mode 100644
--- /dev/null
+++ b/apps/daemon/src/creator/krillin/codex-llm-gateway.ts
@@@ -1,0 -1,0 +1,278 @@@
++import type { FastifyInstance, FastifyReply, FastifyRequest } from 'fastify';
++import { randomBytes, timingSafeEqual } from 'node:crypto';
++import { resolve } from 'node:path';
++import {
++ createCodexAppServerHost,
++ type CodexAppServerHost,
++ type CodexAppServerHostInput
++} from '../../codex/app-server-host-2026-07-28.js';
++
++export const KRILLIN_LLM_ROUTE_PREFIX = '/internal/krillin-llm';
++
++type ChatMessage = { role: 'system' | 'user' | 'assistant'; content: string };
++type HostSlot = { host?: CodexAppServerHost; busy: boolean };
++
++const HOST_POOL_SIZE = 2;
++const MAX_QUEUED_REQUESTS = 32;
++const SSE_HEARTBEAT_MS = 10_000;
++
++export function createKrillinCodexLlmGateway(input: {
++ codexBin: string;
++ codexHome: string;
++ cwd: string;
++ createHost?: typeof createCodexAppServerHost;
++}) {
++ const token = `ocllm_${randomBytes(32).toString('base64url')}`;
++ const slots: HostSlot[] = Array.from({ length: HOST_POOL_SIZE }, () => ({ busy: false }));
++ const waiters: Array<{
++ resolve(slot: HostSlot): void;
++ reject(error: Error): void;
++ }> = [];
++ let closing = false;
++
++ return {
++ config(baseUrl: string) {
++ return {
++ baseUrl: `${baseUrl}${KRILLIN_LLM_ROUTE_PREFIX}/v1`,
++ apiKey: token,
++ model: 'codex'
++ };
++ },
++ async register(server: FastifyInstance): Promise<void> {
++ server.post(`${KRILLIN_LLM_ROUTE_PREFIX}/v1/chat/completions`, async (request, reply) => {
++ if (!authorized(request, token)) {
++ return reply.code(401).send({ error: { message: 'Invalid Krillin LLM token' } });
++ }
++ const body = readBody(request.body, reply);
++ if (body === undefined) return;
++ const messages = readMessages(body.messages, reply);
++ if (messages === undefined) return;
++ const completionId = `chatcmpl-${randomBytes(12).toString('hex')}`;
++ const stream = body.stream === true;
++ if (stream) {
++ reply.hijack();
++ reply.raw.writeHead(200, {
++ 'content-type': 'text/event-stream; charset=utf-8',
++ 'cache-control': 'no-cache, no-transform',
++ connection: 'keep-alive',
++ 'x-accel-buffering': 'no'
++ });
++ reply.raw.write(': connected\n\n');
++ const heartbeat = setInterval(() => reply.raw.write(': keep-alive\n\n'), SSE_HEARTBEAT_MS);
++ heartbeat.unref();
++ try {
++ const content = await runCompletion(messages, readJsonMode(body.response_format));
++ writeSseCompletion(reply, completionId, content);
++ } catch (error) {
++ reply.raw.destroy(toError(error));
++ } finally {
++ clearInterval(heartbeat);
++ }
++ return;
++ }
++ try {
++ const content = await runCompletion(messages, readJsonMode(body.response_format));
++ return chatCompletion(completionId, content);
++ } catch (error) {
++ return reply.code(502).send({
++ error: {
++ message: toError(error).message,
++ type: 'upstream_error',
++ code: 'codex_completion_failed'
++ }
++ });
++ }
++ });
++ },
++ async close(): Promise<void> {
++ closing = true;
++ for (const waiter of waiters.splice(0)) {
++ waiter.reject(new Error('Krillin Codex LLM gateway is closing'));
++ }
++ await Promise.all(slots.map(async slot => {
++ await slot.host?.close('krillin-llm-gateway-closed').catch(() => undefined);
++ slot.host = undefined;
++ }));
++ }
++ };
++
++ async function runCompletion(messages: ChatMessage[], jsonMode: boolean): Promise<string> {
++ const slot = await acquireSlot();
++ try {
++ if (slot.host === undefined || !slot.host.isReusable()) {
++ await slot.host?.close('krillin-llm-host-replaced').catch(() => undefined);
++ slot.host = (input.createHost ?? createCodexAppServerHost)({
++ codexBin: input.codexBin,
++ codexHome: input.codexHome,
++ cwd: resolve(input.cwd),
++ profile: 'default',
++ builtInTools: {
++ shell: false,
++ fileRead: false,
++ fileWrite: false,
++ applyPatch: false,
++ webSearch: false
++ }
++ });
++ await slot.host.started;
++ }
++ return await complete({ host: slot.host, cwd: input.cwd, messages, jsonMode });
++ } catch (error) {
++ if (slot.host?.isReusable() !== true) {
++ await slot.host?.close('krillin-llm-host-failed').catch(() => undefined);
++ slot.host = undefined;
++ }
++ throw error;
++ } finally {
++ releaseSlot(slot);
++ }
++ }
++
++ function acquireSlot(): Promise<HostSlot> {
++ if (closing) return Promise.reject(new Error('Krillin Codex LLM gateway is closing'));
++ const slot = slots.find(candidate => !candidate.busy);
++ if (slot !== undefined) {
++ slot.busy = true;
++ return Promise.resolve(slot);
++ }
++ if (waiters.length >= MAX_QUEUED_REQUESTS) {
++ return Promise.reject(new Error('Krillin Codex LLM request queue is full'));
++ }
++ return new Promise((resolveWaiter, reject) => {
++ waiters.push({ resolve: resolveWaiter, reject });
++ });
++ }
++
++ function releaseSlot(slot: HostSlot): void {
++ const waiter = waiters.shift();
++ if (waiter !== undefined && !closing) {
++ waiter.resolve(slot);
++ return;
++ }
++ slot.busy = false;
++ }
++}
++
++async function complete(input: {
++ host: CodexAppServerHost;
++ cwd: string;
++ messages: ChatMessage[];
++ jsonMode: boolean;
++}): Promise<string> {
++ const messages = new Map<string, string>();
++ const process = input.host.run({
++ cwd: resolve(input.cwd),
++ sandbox: 'read-only',
++ prompt: conversationPrompt(input.messages),
++ developerInstructions: input.jsonMode
++ ? 'Return exactly one valid JSON value. Do not use Markdown fences or commentary. Do not call tools.'
++ : 'Answer the conversation directly. Do not call tools.',
++ timeoutMs: 2 * 60_000,
++ inactivityTimeoutMs: 90_000,
++ onNotification(notification) {
++ recordAgentMessage(messages, notification);
++ }
++ });
++ const result = await process.result;
++ const content = [...messages.values()].at(-1)?.trim() ?? '';
++ if (result.turnStatus !== 'completed') {
++ throw new Error(`Codex LLM completion ended with status ${result.turnStatus}`);
++ }
++ if (content === '') throw new Error('Codex LLM completion returned an empty response');
++ return content;
++}
++
++function chatCompletion(id: string, content: string) {
++ return {
++ id,
++ object: 'chat.completion',
++ created: Math.floor(Date.now() / 1000),
++ model: 'codex',
++ choices: [{ index: 0, message: { role: 'assistant', content }, finish_reason: 'stop' }],
++ usage: { prompt_tokens: 0, completion_tokens: 0, total_tokens: 0 }
++ };
++}
++
++function writeSseCompletion(reply: FastifyReply, id: string, content: string): void {
++ const created = Math.floor(Date.now() / 1000);
++ const chunk = (delta: Record<string, string>, finishReason: string | null) => ({
++ id,
++ object: 'chat.completion.chunk',
++ created,
++ model: 'codex',
++ choices: [{ index: 0, delta, finish_reason: finishReason }]
++ });
++ writeSse(reply, chunk({ role: 'assistant' }, null));
++ writeSse(reply, chunk({ content }, null));
++ writeSse(reply, chunk({}, 'stop'));
++ reply.raw.end('data: [DONE]\n\n');
++}
++
++function writeSse(reply: FastifyReply, value: unknown): void {
++ reply.raw.write(`data: ${JSON.stringify(value)}\n\n`);
++}
++
++function toError(value: unknown): Error {
++ return value instanceof Error ? value : new Error(String(value));
++}
++
++function conversationPrompt(messages: ChatMessage[]): string {
++ return messages.map(message => `${message.role.toUpperCase()}:\n${message.content}`).join('\n\n');
++}
++
++function recordAgentMessage(messages: Map<string, string>, notification: Record<string, unknown>): void {
++ const params = record(notification.params);
++ const item = record(params?.item);
++ const id = typeof params?.itemId === 'string'
++ ? params.itemId
++ : typeof item?.id === 'string' ? item.id : undefined;
++ if (id === undefined) return;
++ if (item?.type === 'agentMessage' && typeof item.text === 'string') {
++ messages.set(id, item.text);
++ } else if (notification.method === 'item/agentMessage/delta' && typeof params?.delta === 'string') {
++ messages.set(id, (messages.get(id) ?? '') + params.delta);
++ }
++}
++
++function authorized(request: FastifyRequest, token: string): boolean {
++ const value = request.headers.authorization?.replace(/^Bearer\s+/i, '') ?? '';
++ const left = Buffer.from(value);
++ const right = Buffer.from(token);
++ return left.length === right.length && timingSafeEqual(left, right);
++}
++
++function readBody(value: unknown, reply: FastifyReply): Record<string, unknown> | undefined {
++ const body = record(value);
++ if (body !== undefined) return body;
++ void reply.code(400).send({ error: { message: 'Request body must be an object' } });
++ return undefined;
++}
++
++function readMessages(value: unknown, reply: FastifyReply): ChatMessage[] | undefined {
++ if (!Array.isArray(value) || value.length === 0) {
++ void reply.code(400).send({ error: { message: 'messages must be a non-empty array' } });
++ return undefined;
++ }
++ const messages = value.flatMap(candidate => {
++ const message = record(candidate);
++ return (message?.role === 'system' || message?.role === 'user' || message?.role === 'assistant')
++ && typeof message.content === 'string'
++ ? [{ role: message.role, content: message.content } satisfies ChatMessage]
++ : [];
++ });
++ if (messages.length !== value.length) {
++ void reply.code(400).send({ error: { message: 'messages contain an unsupported value' } });
++ return undefined;
++ }
++ return messages;
++}
++
++function readJsonMode(value: unknown): boolean {
++ return record(value)?.type === 'json_object';
++}
++
++function record(value: unknown): Record<string, unknown> | undefined {
++ return value !== null && typeof value === 'object' && !Array.isArray(value)
++ ? value as Record<string, unknown>
++ : undefined;
++}
diff --cc apps/daemon/src/creator/krillin/config-bridge.ts
index d1dda8f0,a3f555ca..8879ddff
--- a/apps/daemon/src/creator/krillin/config-bridge.ts
+++ b/apps/daemon/src/creator/krillin/config-bridge.ts
@@@ -1,13 -1,13 +1,17 @@@
import { stringify } from '@iarna/toml';
import type { CreatorServicesConfig } from '@opencreator/protocol';
--export function createKrillinConfigToml(config: CreatorServicesConfig): string {
++export function createKrillinConfigToml(
++ config: CreatorServicesConfig,
++ llmOverride?: { baseUrl: string; apiKey: string; model: string }
++): string {
++ const llm = llmOverride ?? config.llm;
const document = compact({
app: { proxy: config.proxy },
llm: {
-- base_url: config.llm.baseUrl,
-- api_key: config.llm.apiKey,
-- model: config.llm.model,
++ base_url: llm.baseUrl,
++ api_key: llm.apiKey,
++ model: llm.model,
json: config.llm.jsonMode
},
transcribe: {
diff --cc apps/daemon/src/creator/preflight.ts
index 171920a6,00000000..cfa132f0
mode 100644,000000..100644
--- a/apps/daemon/src/creator/preflight.ts
+++ b/apps/daemon/src/creator/preflight.ts
@@@ -1,379 -1,0 +1,404 @@@
+import type {
+ CreatorJob,
+ CreatorPreflightCheck,
+ CreatorPreflightExecutionMode,
+ CreatorPreflightResponse,
+ CreatorServicesCapabilitiesResponse,
+ CreatorServicesConfig
+} from '@opencreator/protocol';
+import { access, mkdir } from 'node:fs/promises';
+import { constants } from 'node:fs';
+import { join } from 'node:path';
+import type { CreatorTemplateStage } from './templates/types.js';
+import type { CreatorServicesConfigStore } from '../creator-services/config-store.js';
+import { preflightKrillinDependencies } from './krillin/dependency-preflight.js';
+import type { YtDlpRuntime } from './yt-dlp/runtime.js';
- import { supportsReferenceImage } from './templates/cover-actions.js';
++import {
++ imageProviderConfigured,
++ resolveCreatorImageSettings
++} from './image-settings.js';
+import { creatorResultSnapshotForVersion } from './result-snapshots.js';
+import { resolveCreatorStageInputs } from './stage-runner.js';
+import { readStickmanRemotionRuntime } from './stickman/remotion-runtime.js';
+
+export type CreatorPreflight = ReturnType<typeof createCreatorPreflight>;
+
+export type CreatorPreflightOptions = {
+ inputResultVersion?: number;
+};
+
+export class CreatorPreflightError extends Error {
+ constructor(readonly result: CreatorPreflightResponse) {
+ super('Creator preflight blocked this stage');
+ this.name = 'CreatorPreflightError';
+ }
+
+ get code(): string {
+ const ids = new Set(this.result.blocked.map(item => item.id));
+ const id = ids.has('llm') ? 'llm'
+ : ids.has('tts') ? 'tts'
+ : ids.has('image-provider') ? 'image-provider'
+ : ids.has('video-provider') ? 'video-provider'
+ : ids.has('reference-image-capability') ? 'reference-image-capability'
+ : this.result.blocked[0]?.id;
+ if (id === 'llm') return 'creator_llm_config_missing';
+ if (id === 'tts') return 'creator_tts_config_missing';
+ if (id === 'image-provider') return 'creator_image_config_missing';
+ if (id === 'video-provider') return 'VIDEO_GENERATION_CONFIG_REQUIRED';
+ if (id === 'reference-image-capability') return 'unsupported_capability';
+ return 'creator_preflight_blocked';
+ }
+}
+
+export function createCreatorPreflight(input: {
+ configStore: Pick<CreatorServicesConfigStore, 'read'>;
+ readCapabilities(): CreatorServicesCapabilitiesResponse;
+ resourceRoot: string;
+ jobsRoot: string;
+ ffmpegPath?: string;
+ ffprobePath?: string;
+ stickmanRuntimeRoot?: string;
+ getYtDlpRuntime?(): YtDlpRuntime | undefined;
+ executorIds?: Iterable<string>;
+ validateRuntimeAssets?: boolean;
+}) {
+ const executorIds = new Set(input.executorIds ?? []);
+
+ async function check(job: CreatorJob, stage: CreatorTemplateStage, options: CreatorPreflightOptions = {}): Promise<CreatorPreflightResponse> {
+ const ready: CreatorPreflightCheck[] = [];
+ const warning: CreatorPreflightCheck[] = [];
+ const blocked: Array<CreatorPreflightCheck & { repair: NonNullable<CreatorPreflightCheck['repair']> }> = [];
+ const mode = executionMode(stage, job);
+ const add = (
+ status: 'ready' | 'warning' | 'blocked',
+ item: Omit<CreatorPreflightCheck, 'executionMode'> & { executionMode?: CreatorPreflightExecutionMode },
+ repair?: CreatorPreflightCheck['repair']
+ ) => {
+ const value = { ...item, executionMode: item.executionMode ?? mode };
+ if (status === 'ready') ready.push(value);
+ else if (status === 'warning') warning.push(value);
+ else blocked.push({ ...value, repair: repair ?? { label: '打开设置', deepLink: '#/settings?tab=diagnostics' } });
+ };
+
+ if (executorIds.size > 0 && !executorIds.has(stage.executor)) {
+ add('blocked', {
+ id: 'executor',
+ title: '执行器不可用',
+ message: `当前 Runtime 未加载 ${stage.executor} 执行器。`,
+ executionMode: mode
+ }, { label: '打开诊断', deepLink: '#/settings?tab=diagnostics' });
+ } else {
+ add('ready', { id: 'executor', title: '执行器', message: `${stage.executor} 已加载`, executionMode: mode });
+ }
+
+ const config = await input.configStore.read();
+ checkProviderConfig(job, stage, config, input.readCapabilities(), add);
+ const inputSnapshot = options.inputResultVersion === undefined
+ ? undefined
+ : creatorResultSnapshotForVersion(job, options.inputResultVersion);
+ if (options.inputResultVersion !== undefined && inputSnapshot === undefined) {
+ add('blocked', {
+ id: 'input-result-version',
+ title: '结果版本不存在',
+ message: `找不到结果版本 ${options.inputResultVersion},无法安全复用历史输入。`,
+ executionMode: 'local'
+ }, { label: '打开诊断', deepLink: '#/settings?tab=diagnostics' });
+ }
+ const inputState = inputSnapshot?.state ?? job.state;
+ if (inputState.sourceType === 'file' && stage.executor === 'krillinai' && typeof inputState.sourceArtifactId !== 'string') {
+ add('blocked', {
+ id: 'input-file',
+ title: '输入文件缺失',
+ message: '请选择要处理的本地视频文件。',
+ executionMode: 'local'
+ }, { label: '选择输入文件', deepLink: '#/settings?tab=diagnostics' });
+ }
+ const resolvedInputs = resolveCreatorStageInputs(
+ job,
+ stage.inputArtifacts,
+ inputSnapshot?.artifactRefs,
+ inputSnapshot?.state
+ );
+ await checkInputs(stage, resolvedInputs.artifacts, resolvedInputs.missing, add);
+ await checkRuntimeDependencies(job, stage, config, add);
+ await checkManagedDirectory(add);
+
+ return {
+ templateId: job.templateId,
+ templateVersion: job.templateVersion,
+ stageId: stage.id,
+ executionMode: mode,
+ canStart: blocked.length === 0,
+ ready,
+ warning,
+ blocked,
+ checkedAt: new Date().toISOString()
+ };
+ }
+
+ return { check };
+
+ async function checkManagedDirectory(
+ add: (status: 'ready' | 'warning' | 'blocked', item: Omit<CreatorPreflightCheck, 'executionMode'> & { executionMode?: CreatorPreflightExecutionMode }, repair?: CreatorPreflightCheck['repair']) => void
+ ) {
+ try {
+ await mkdir(input.jobsRoot, { recursive: true });
+ await access(input.jobsRoot, constants.W_OK);
+ add('ready', { id: 'managed-directory', title: '受管目录', message: '任务目录可写。', executionMode: 'local' });
+ } catch {
+ add('blocked', {
+ id: 'managed-directory',
+ title: '受管目录不可写',
+ message: 'OpenCreator 无法写入任务目录,无法安全保存 Artifact。',
+ executionMode: 'local'
+ }, { label: '打开诊断', deepLink: '#/settings?tab=diagnostics' });
+ }
+ }
+
+ async function checkRuntimeDependencies(
+ job: CreatorJob,
+ stage: CreatorTemplateStage,
+ config: CreatorServicesConfig,
+ add: (status: 'ready' | 'warning' | 'blocked', item: Omit<CreatorPreflightCheck, 'executionMode'> & { executionMode?: CreatorPreflightExecutionMode }, repair?: CreatorPreflightCheck['repair']) => void
+ ) {
+ if (input.validateRuntimeAssets !== false) {
+ const requiredTools = new Map<string, string | undefined>();
+ if (['download', 'clip', 'krillinai', 'stickman-media-validation'].includes(stage.executor)) requiredTools.set('ffmpeg', input.ffmpegPath);
+ if (['download', 'clip', 'krillinai', 'stickman-audio', 'stickman-remotion', 'stickman-media-validation', 'stickman-delivery'].includes(stage.executor)) requiredTools.set('ffprobe', input.ffprobePath);
+ for (const [id, path] of requiredTools) {
+ const label = id === 'ffmpeg' ? 'FFmpeg' : 'ffprobe';
+ if (path === undefined) add('blocked', {
+ id,
+ title: `${label} 不可用`,
+ message: `当前 Runtime 未找到 ${label},该阶段无法执行。`,
+ executionMode: 'local'
+ }, { label: '打开运行组件设置', deepLink: '#/settings?tab=local-components' });
+ else add('ready', { id, title: label, message: `${label} 已就绪。`, executionMode: 'local' });
+ }
+ if (stage.executor === 'stickman-delivery' && input.ffmpegPath === undefined) {
+ add('warning', { id: 'ffmpeg', title: 'FFmpeg 不可用', message: '交付校验将跳过视频帧采样。', executionMode: 'local' });
+ }
+ if (stage.executor === 'stickman-remotion') {
+ try {
+ if (input.stickmanRuntimeRoot === undefined) throw new Error('stickman_runtime_unavailable');
+ readStickmanRemotionRuntime(input.stickmanRuntimeRoot);
+ add('ready', { id: 'stickman-runtime', title: 'Stickman 渲染运行时', message: 'Remotion 运行资源校验通过。', executionMode: 'local' });
+ } catch (error) {
+ add('blocked', {
+ id: 'stickman-runtime',
+ title: 'Stickman 渲染运行时不可用',
+ message: error instanceof Error ? error.message : 'Remotion 运行资源校验失败。',
+ executionMode: 'local'
+ }, { label: '打开运行组件设置', deepLink: '#/settings?tab=local-components' });
+ }
+ }
+ }
+ if (input.validateRuntimeAssets !== false && (stage.executor === 'download' || stage.executor === 'cover-analysis' || (stage.executor === 'krillinai' && job.state.sourceType !== 'file'))) {
+ let runtime: YtDlpRuntime | undefined;
+ try { runtime = input.getYtDlpRuntime?.(); } catch { runtime = undefined; }
+ if (runtime === undefined) add('blocked', {
+ id: 'yt-dlp',
+ title: 'yt-dlp 不可用',
+ message: '当前 Runtime 未找到 yt-dlp,无法处理远程媒体。',
+ executionMode: 'local'
+ }, { label: '打开运行组件设置', deepLink: '#/settings?tab=local-components' });
+ else add('ready', { id: 'yt-dlp', title: 'yt-dlp', message: `已就绪(${runtime.version})。`, executionMode: 'local' });
+ }
+ if (input.validateRuntimeAssets !== false && stage.executor === 'krillinai') {
+ try {
+ preflightKrillinDependencies(input.resourceRoot, config);
+ add('ready', { id: 'krillin-runtime', title: 'KrillinAI Runtime', message: '运行资源校验通过。', executionMode: 'local' });
+ } catch (error) {
+ add('blocked', {
+ id: 'krillin-runtime',
+ title: 'KrillinAI Runtime 不完整',
+ message: error instanceof Error ? error.message : 'KrillinAI 运行资源校验失败。',
+ executionMode: 'local'
+ }, { label: '打开运行组件设置', deepLink: '#/settings?tab=local-components' });
+ }
+ }
+ if (stage.executor === 'krillinai' && (job.state.sourceType === 'file' || job.state.preferPlatformCaptions === false) && ['whisper.cpp', 'whisperkit', 'faster-whisper'].includes(config.transcription.provider)) {
+ const provider = input.readCapabilities().transcription.providers.find(candidate => candidate.provider === config.transcription.provider);
+ if (provider?.available !== true) add('blocked', {
+ id: 'transcription-capability',
+ title: '语音识别能力不可用',
+ message: `${config.transcription.provider} 在当前 Runtime 不可用。`,
+ executionMode: 'local'
+ }, { label: '打开 AI 服务设置', deepLink: '#/settings?tab=ai-services&section=transcription' });
+ }
+ }
+}
+
+function checkProviderConfig(
+ job: CreatorJob,
+ stage: CreatorTemplateStage,
+ config: CreatorServicesConfig,
+ capabilities: CreatorServicesCapabilitiesResponse,
+ add: (status: 'ready' | 'warning' | 'blocked', item: Omit<CreatorPreflightCheck, 'executionMode'> & { executionMode?: CreatorPreflightExecutionMode }, repair?: CreatorPreflightCheck['repair']) => void
+): void {
+ const needs = new Set<string>();
+ if (stage.executor === 'krillinai') {
+ if (
+ stage.id === 'subtitle'
+ && !job.artifacts.some(artifact => (
+ artifact.id === job.state.importedTargetSubtitleId
+ && artifact.kind === 'target_subtitle'
+ && artifact.status === 'completed'
+ ))
+ ) needs.add('llm');
+ if (stage.id === 'tts' && job.state.dubbing === true) needs.add('tts');
+ }
+ if (stage.executor === 'clip') needs.add('llm');
+ if (stage.executor === 'stickman-content' && ['source-brief', 'content-plan', 'script', 'storyboard'].includes(stage.id)) needs.add('llm');
+ if (stage.executor === 'cover-analysis') needs.add('llm');
+ if (stage.executor === 'image') {
+ needs.add('image');
+ if (stage.id === 'analyze-source') needs.add('llm');
+ }
+ if (stage.executor === 'video') needs.add('video');
+ if (stage.executor === 'smart-dubbing') needs.add('tts');
+ if (stage.executor === 'stickman-audio' && stage.id === 'narration') needs.add('tts');
+ if (stage.executor === 'stickman-image') needs.add('image');
+
- if (needs.has('llm')) checkOpenAi(config.llm, 'llm', '文本模型', '#/settings?tab=ai-services&section=text', add);
++ if (needs.has('llm')) {
++ if (config.llm.source === 'codex' && stage.executor === 'krillinai') {
++ add('ready', {
++ id: 'llm',
++ title: '文本模型',
++ message: `本机 Codex / ${config.llm.model || 'Runtime'} 已启用。`,
++ executionMode: 'local'
++ });
++ } else {
++ checkOpenAi(config.llm, 'llm', '文本模型', '#/settings?tab=ai-services&section=text', add);
++ }
++ }
+ if (needs.has('tts')) {
+ const provider = readTtsProvider(job, config);
+ if (provider === 'edge-tts') add('ready', { id: 'tts', title: '配音服务', message: 'Edge TTS 不需要 API Key。', executionMode: 'remote' });
+ else checkTts(config, provider, add);
+ }
+ if (needs.has('image')) {
- const provider = readImageProvider(job, config);
- const settings = config.image[provider];
- const hasKey = providerCredentials(settings, provider);
- if (!hasKey || !settings.model.trim() || !settings.baseUrl.trim()) add('blocked', {
- id: 'image-provider', title: '图像服务配置不完整', message: `请配置 ${provider} 的 Base URL、模型和凭据。`, executionMode: 'remote'
- }, { label: '打开 AI 服务设置', deepLink: '#/settings?tab=ai-services&section=image' });
- else add('ready', { id: 'image-provider', title: '图像服务', message: `${provider} / ${settings.model} 已配置。`, executionMode: 'remote' });
++ const settings = resolveCreatorImageSettings({
++ config,
++ provider: job.state.provider,
++ candidateCount: job.state.candidateCount,
++ fallbackCandidateCount: job.templateId === 'image-generation' ? 2 : 1,
++ maxCandidateCount: job.templateId === 'image-generation' ? 4 : 8
++ });
++ const { provider } = settings;
++ if (imageProviderConfigured(config, provider)) {
++ add('ready', {
++ id: 'image-provider',
++ title: '图像服务',
++ message: provider === 'codex-native'
++ ? '本机 Codex 生图已启用。'
++ : `${provider} / ${settings.model} 已配置。`,
++ executionMode: settings.executionMode
++ });
++ } else {
++ add('blocked', {
++ id: 'image-provider', title: '图像服务配置不完整', message: `请配置 ${provider} 的 Base URL、模型和凭据。`, executionMode: settings.executionMode
++ }, { label: '打开 AI 服务设置', deepLink: '#/settings?tab=ai-services&section=image' });
++ }
+ const hasReference = stage.executor === 'stickman-image'
+ || (stage.inputArtifacts.some(item => item.kind === 'reference_image')
+ && typeof job.state.referenceImageArtifactId === 'string');
- if (hasReference && !supportsReferenceImage(provider)) add('blocked', {
++ if (hasReference && !settings.supportsReferenceImage) add('blocked', {
+ id: 'reference-image-capability', title: '参考图能力不匹配', message: `${provider} 不支持当前阶段的参考图编辑。`, executionMode: 'remote'
+ }, { label: '选择支持参考图的服务', deepLink: '#/settings?tab=ai-services&section=image' });
+ }
+ if (needs.has('video')) {
+ const provider = readVideoProvider(job, config);
+ const settings = config.video[provider];
+ const hasKey = providerCredentials(settings, provider);
+ if (!hasKey || !settings.model.trim() || !settings.baseUrl.trim()) add('blocked', {
+ id: 'video-provider', title: '视频服务配置不完整', message: `请配置 ${provider} 的 Base URL、模型和凭据。`, executionMode: 'remote'
+ }, { label: '打开 AI 服务设置', deepLink: '#/settings?tab=ai-services&section=video' });
+ else add('ready', { id: 'video-provider', title: '视频服务', message: `${provider} / ${settings.model} 已配置。`, executionMode: 'remote' });
+ }
+ if (stage.executor === 'krillinai' && stage.id === 'subtitle' && (job.state.sourceType === 'file' || job.state.preferPlatformCaptions === false)) {
+ const provider = capabilities.transcription.providers.find(candidate => candidate.provider === config.transcription.provider);
+ if (provider?.available !== true) return;
+ if (config.transcription.provider === 'openai' && !config.transcription.openai.apiKey.trim()) {
+ checkOpenAi(config.transcription.openai, 'transcription', '语音识别', '#/settings?tab=ai-services&section=transcription', add);
+ } else if (config.transcription.provider === 'aliyun' && (!config.transcription.aliyun.speech.accessKeyId.trim() || !config.transcription.aliyun.speech.accessKeySecret.trim() || !config.transcription.aliyun.speech.appKey.trim())) {
+ add('blocked', { id: 'transcription-config', title: '语音识别凭据缺失', message: '请补全阿里云语音识别凭据。', executionMode: 'remote' }, { label: '打开 AI 服务设置', deepLink: '#/settings?tab=ai-services&section=transcription' });
+ } else if (config.transcription.provider === 'volcengine' && (!config.transcription.volcengine.appId.trim() || !config.transcription.volcengine.accessToken.trim())) {
+ add('blocked', { id: 'transcription-config', title: '语音识别凭据缺失', message: '请补全火山引擎 App ID 和 Access Token。', executionMode: 'remote' }, { label: '打开 AI 服务设置', deepLink: '#/settings?tab=ai-services&section=transcription' });
+ } else add('ready', { id: 'transcription-config', title: '语音识别', message: `${config.transcription.provider} 已配置。`, executionMode: provider.kind === 'local' ? 'local' : 'remote' });
+ }
+}
+
+function checkOpenAi(
+ value: { baseUrl: string; apiKey: string; model: string },
+ id: string,
+ title: string,
+ deepLink: string,
+ add: Parameters<typeof checkProviderConfig>[4]
+) {
+ if (!value.baseUrl.trim() || !value.model.trim() || !value.apiKey.trim()) add('blocked', { id, title: `${title}配置不完整`, message: `请补全 ${title} 的 Base URL、模型和 API Key。`, executionMode: 'remote' }, { label: '打开 AI 服务设置', deepLink });
+ else add('ready', { id, title, message: `${value.model} 已配置。`, executionMode: 'remote' });
+}
+
+function checkTts(config: CreatorServicesConfig, provider: Exclude<CreatorServicesConfig['tts']['provider'], 'edge-tts'>, add: Parameters<typeof checkProviderConfig>[4]) {
+ const credentialsReady = provider === 'volcengine'
+ ? Boolean(config.tts.volcengine.appId.trim() && config.tts.volcengine.accessToken.trim())
+ : Boolean(config.tts[provider].apiKey.trim());
+ const value = config.tts[provider];
+ if (!value.baseUrl.trim() || !value.model.trim() || !credentialsReady) add('blocked', { id: 'tts', title: '配音服务配置不完整', message: `请补全 ${provider} 的 Base URL、模型和凭据。`, executionMode: 'remote' }, { label: '打开 AI 服务设置', deepLink: '#/settings?tab=ai-services&section=tts' });
+ else add('ready', { id: 'tts', title: '配音服务', message: `${provider} / ${value.model} 已配置。`, executionMode: 'remote' });
+}
+
+async function checkInputs(
+ stage: CreatorTemplateStage,
+ artifacts: Array<CreatorJob['artifacts'][number]>,
+ missing: string[],
+ add: Parameters<typeof checkProviderConfig>[4]
+): Promise<void> {
+ for (const kind of missing) {
+ add('blocked', { id: `input-artifact:${kind}`, title: '前置产物缺失', message: `请先生成 ${kind},再启动 ${stage.id}。`, executionMode: 'local' }, { label: '返回上一步', deepLink: '#/settings?tab=diagnostics' });
+ }
+ for (const artifact of artifacts) {
+ if (artifact.path === null) {
+ add('blocked', { id: 'input-file', title: '输入文件不可用', message: '所选输入文件不存在或不可读。', executionMode: 'local' }, { label: '重新选择输入文件', deepLink: '#/settings?tab=diagnostics' });
+ continue;
+ }
+ try {
+ await access(artifact.path, constants.R_OK);
+ add('ready', { id: `input-file:${artifact.id}`, title: '输入文件', message: '输入文件存在且可读。', executionMode: 'local' });
+ } catch {
+ add('blocked', { id: 'input-file', title: '输入文件不可读', message: '所选输入文件不存在或不可读。', executionMode: 'local' }, { label: '重新选择输入文件', deepLink: '#/settings?tab=diagnostics' });
+ }
+ }
+}
+
+function readTtsProvider(job: CreatorJob, config: CreatorServicesConfig): CreatorServicesConfig['tts']['provider'] {
+ const value = job.state.ttsProvider;
+ return value === 'openai' || value === 'aliyun' || value === 'edge-tts' || value === 'minimax' || value === 'volcengine' ? value : config.tts.provider;
+}
- function readImageProvider(job: CreatorJob, config: CreatorServicesConfig): CreatorServicesConfig['image']['provider'] {
- const value = job.state.provider;
- return value === 'openai' || value === 'jimeng' || value === 'kling' || value === 'gemini' ? value : config.image.provider;
- }
+function readVideoProvider(job: CreatorJob, config: CreatorServicesConfig): CreatorServicesConfig['video']['provider'] {
+ const value = job.state.provider;
+ return value === 'seedance' || value === 'kling' || value === 'veo' ? value : config.video.provider;
+}
+function executionMode(stage: CreatorTemplateStage, job: CreatorJob): CreatorPreflightExecutionMode {
+ if (stage.executor === 'image' || stage.executor === 'video' || stage.executor === 'smart-dubbing' || stage.executor === 'stickman-image') return 'remote';
+ if (
+ stage.executor === 'cover-analysis'
+ || (stage.executor === 'clip')
+ || (stage.executor === 'stickman-content' && ['source-brief', 'content-plan', 'script', 'storyboard'].includes(stage.id))
+ || (stage.executor === 'stickman-audio' && stage.id === 'narration')
+ ) return 'mixed';
+ if (stage.executor === 'krillinai' && job.state.sourceType !== 'file') return 'mixed';
+ return 'local';
+}
+
+function providerCredentials(
+ settings: { model: string; apiKey?: string; accessKey?: string; secretKey?: string },
+ provider: 'openai' | 'jimeng' | 'kling' | 'gemini' | 'seedance' | 'veo'
+): boolean {
+ if (provider === 'kling') {
+ return (settings.accessKey?.trim().length ?? 0) > 0
+ && (settings.secretKey?.trim().length ?? 0) > 0;
+ }
+ return (settings.apiKey?.trim().length ?? 0) > 0;
+}
diff --cc apps/daemon/src/creator/presets/module-schemas.ts
index b98021fb,601e7ecd..b16480e3
--- a/apps/daemon/src/creator/presets/module-schemas.ts
+++ b/apps/daemon/src/creator/presets/module-schemas.ts
@@@ -5,7 -5,7 +5,6 @@@ import
creatorRuntimeWorkspaces,
imageGenerationSizes,
videoGenerationDurations,
-- videoGenerationModelIds,
videoGenerationSizes,
type CreatorJson,
type CreatorPresetRequirements,
@@@ -179,40 -179,40 +178,26 @@@ function validateModuleRequirement
requirement: CreatorPresetRequirements | undefined
): void {
if (requirement === undefined) return;
-- if (module === 'image-generation' || module === 'cover-generator') {
-- if (requirement.service !== 'image') {
-- throw new Error(`${module}: requirement service must be image`);
-- }
- if (!['openai', 'jimeng', 'kling', 'gemini'].includes(requirement.provider)) {
- if (!['openai', 'jimeng', 'kling', 'gemini', 'codex-native'].includes(requirement.provider)) {
-- throw new Error(`${module}: unsupported image provider ${requirement.provider}`);
-- }
-- if (requirement.model !== undefined) {
-- throw new Error(`${module}: image requirements cannot select a model`);
-- }
-- return;
++ const expected = module === 'image-generation' || module === 'cover-generator'
++ ? 'image'
++ : module === 'video-generation'
++ ? 'video'
++ : module === 'smart-dubbing' || module === 'video-translation'
++ ? 'tts'
++ : undefined;
++ if (expected === undefined) throw new Error(`${module}: requirements are not supported`);
++ if (requirement.service !== expected) {
++ throw new Error(`${module}: requirement service must be ${expected}`);
}
-- if (module === 'video-generation') {
-- if (requirement.service !== 'video') {
-- throw new Error(`${module}: requirement service must be video`);
-- }
-- const models = videoGenerationModelIds[
-- requirement.provider as keyof typeof videoGenerationModelIds
-- ] as readonly string[] | undefined;
-- if (models === undefined || requirement.model === undefined || !models.includes(requirement.model)) {
-- throw new Error(`${module}: unsupported video provider or model`);
-- }
-- return;
++ const allowed = {
++ image: ['text-to-image', 'reference-image', 'image-edit'],
++ video: ['text-to-video', 'image-to-video'],
++ tts: ['speech-generation', 'voice-preview']
++ }[expected] as readonly string[];
++ const unsupported = requirement.capabilities.find(capability => !allowed.includes(capability));
++ if (unsupported !== undefined) {
++ throw new Error(`${module}: unsupported ${expected} capability ${unsupported}`);
}
-- if (module === 'smart-dubbing' || module === 'video-translation') {
-- if (requirement.service !== 'tts') {
-- throw new Error(`${module}: requirement service must be tts`);
-- }
-- if (!['openai', 'aliyun', 'minimax'].includes(requirement.provider)) {
-- throw new Error(`${module}: unsupported tts provider ${requirement.provider}`);
-- }
-- return;
-- }
-- throw new Error(`${module}: requirements are not supported`);
}
export function isCreatorPresetModule(value: string): value is CreatorRuntimeWorkspace {
diff --cc apps/daemon/src/creator/presets/requirements.ts
index 5de35c26,867a4675..dffdaa49
--- a/apps/daemon/src/creator/presets/requirements.ts
+++ b/apps/daemon/src/creator/presets/requirements.ts
@@@ -5,6 -5,6 +5,8 @@@ import type
CreatorRuntimeWorkspace,
CreatorServicesConfig
} from '@opencreator/protocol';
++import { creatorProviderOfKind } from '@opencreator/protocol';
++import { imageProviderConfigured } from '../image-settings.js';
import { videoGenerationModelIds } from '@opencreator/protocol';
import { CreatorExecutorError } from '../executor.js';
import type { CreatorPresetModuleDefinition, CreatorPresetLocale } from './types.js';
@@@ -35,13 -35,13 +37,11 @@@ export function resolveCreatorPresetReq
requirement?: CreatorPresetRequirements;
services: CreatorServicesConfig;
}): Record<string, CreatorJson> {
-- const requirement = input.requirement;
if (input.module === 'image-generation' || input.module === 'cover-generator') {
-- const provider = requirement?.provider ?? input.services.image.provider;
-- return { provider };
++ return { provider: input.services.image.provider };
}
if (input.module === 'video-generation') {
-- const provider = requirement?.provider ?? input.services.video.provider;
++ const provider = input.services.video.provider;
const providerConfig = input.services.video[
provider as keyof CreatorServicesConfig['video']
];
@@@ -53,11 -53,11 +53,11 @@@
) ? providerConfig.model : '';
return {
provider,
-- model: requirement?.model ?? configuredModel
++ model: configuredModel
};
}
if (input.module === 'smart-dubbing' || input.module === 'video-translation') {
-- const provider = requirement?.provider ?? input.services.tts.provider;
++ const provider = input.services.tts.provider;
const providerConfig = input.services.tts[
provider as keyof CreatorServicesConfig['tts']
];
@@@ -66,7 -66,7 +66,7 @@@
}
return {
ttsProvider: provider,
-- ttsModel: requirement?.model ?? providerConfig.model,
++ ttsModel: providerConfig.model,
voiceCode: providerConfig.defaultVoiceId,
voiceName: providerConfig.defaultVoiceId
};
@@@ -89,25 -89,25 +89,18 @@@ export function assertCreatorPresetStag
if (input.job.presetOrigin == null) return;
const service = requiredServiceForStage(input.job, input.stageId);
if (service === undefined) return;
-- const snapshot = readRequirementSnapshot(input.job, service);
++ const capabilities = readRequirementCapabilities(input.job, service);
if (service === 'image') {
-- const provider = requiredProvider(
-- service,
-- input.job.state.provider,
-- snapshot?.provider
-- );
++ const provider = requiredProvider(service, input.job.state.provider);
if (!hasImageCredentials(input.services, provider)) {
missingRequirement(service, provider);
}
++ assertProviderCapabilities(service, provider, capabilities);
return;
}
if (service === 'video') {
-- const provider = requiredProvider(
-- service,
-- input.job.state.provider,
-- snapshot?.provider
-- );
-- const model = readString(input.job.state.model) ?? snapshot?.model;
++ const provider = requiredProvider(service, input.job.state.provider);
++ const model = readString(input.job.state.model);
const allowedModels = videoGenerationModelIds[
provider as keyof typeof videoGenerationModelIds
] as readonly string[] | undefined;
@@@ -116,25 -116,25 +109,21 @@@
|| model === undefined
|| allowedModels === undefined
|| !allowedModels.includes(model)
-- || (snapshot?.model !== undefined && snapshot.model !== model)
) {
missingRequirement(service, provider, model);
}
++ assertProviderCapabilities(service, provider, capabilities);
return;
}
-- const provider = requiredProvider(
-- service,
-- input.job.state.ttsProvider,
-- snapshot?.provider
-- );
-- const model = readString(input.job.state.ttsModel) ?? snapshot?.model;
++ const provider = requiredProvider(service, input.job.state.ttsProvider);
++ const model = readString(input.job.state.ttsModel);
if (
!hasTtsCredentials(input.services, provider)
|| model === undefined
-- || (snapshot?.model !== undefined && snapshot.model !== model)
) {
missingRequirement(service, provider, model);
}
++ assertProviderCapabilities(service, provider, capabilities);
}
function deepMerge(
@@@ -182,38 -182,38 +171,46 @@@ function requiredServiceForStage
return undefined;
}
--function readRequirementSnapshot(
++function readRequirementCapabilities(
job: CreatorJob,
service: CreatorPresetRequirements['service']
--): CreatorPresetRequirements | undefined {
++): string[] {
const details = job.activities.find(activity => activity.action === 'create-job')?.details;
-- if (
-- details?.requirementService !== service
-- || typeof details.requirementProvider !== 'string'
-- ) {
-- return undefined;
++ if (details?.requirementService !== service || !Array.isArray(details.requirementCapabilities)) {
++ return [];
}
-- return {
-- service,
-- provider: details.requirementProvider,
-- ...(typeof details.requirementModel === 'string'
-- ? { model: details.requirementModel }
-- : {})
-- };
++ return details.requirementCapabilities.filter(value => typeof value === 'string');
}
function requiredProvider(
service: CreatorPresetRequirements['service'],
-- value: CreatorJson | undefined,
-- required?: string
++ value: CreatorJson | undefined
): string {
-- const provider = readString(value) ?? required;
-- if (provider === undefined || (required !== undefined && provider !== required)) {
-- missingRequirement(service, required ?? 'unknown');
-- }
++ const provider = readString(value);
++ if (provider === undefined) missingRequirement(service, 'unknown');
return provider;
}
++function assertProviderCapabilities(
++ service: CreatorPresetRequirements['service'],
++ provider: string,
++ required: readonly string[]
++): void {
++ const catalogId = service === 'video' && provider === 'kling'
++ ? 'kling-video'
++ : service === 'tts' ? `${provider}-tts` : provider;
++ const entry = creatorProviderOfKind(service, catalogId);
++ const supported = new Set(entry?.capabilities ?? []);
++ const missing = required.find(capability => !supported.has(capability));
++ if (missing !== undefined) {
++ throw new CreatorExecutorError(
++ 'creator_preset_requirement_missing',
++ `The selected ${service} provider does not support the required capability: ${missing}`,
++ { service, provider, capability: missing }
++ );
++ }
++}
++
function readString(value: CreatorJson | undefined): string | undefined {
return typeof value === 'string' && value.trim() ? value.trim() : undefined;
}
@@@ -222,14 -222,15 +219,14 @@@ function hasImageCredentials
services: CreatorServicesConfig,
provider: string
): boolean {
- if (provider === 'codex-native') return true;
-- if (provider === 'kling') {
-- return services.image.kling.accessKey.trim() !== ''
-- && services.image.kling.secretKey.trim() !== '';
-- }
-- if (provider === 'openai' || provider === 'jimeng' || provider === 'gemini') {
-- return services.image[provider].apiKey.trim() !== '';
-- }
-- return false;
++ if (
++ provider !== 'openai'
++ && provider !== 'jimeng'
++ && provider !== 'kling'
++ && provider !== 'gemini'
++ && provider !== 'codex-native'
++ ) return false;
++ return imageProviderConfigured(services, provider);
}
function hasVideoCredentials(
diff --cc apps/daemon/src/creator/presets/schema.ts
index f95dcc8e,f95dcc8e..c8548622
--- a/apps/daemon/src/creator/presets/schema.ts
+++ b/apps/daemon/src/creator/presets/schema.ts
@@@ -1,4 -1,4 +1,5 @@@
import {
++ creatorPresetCapabilities,
creatorRuntimeWorkspaces,
type CreatorJson,
type CreatorPresetRequirements
@@@ -12,8 -12,8 +13,7 @@@ const localeTextSchema = z.object(
const requirementSchema = z.object({
service: z.enum(['tts', 'image', 'video']),
-- provider: z.string().trim().min(1).max(64),
-- model: z.string().trim().min(1).max(128).optional()
++ capabilities: z.array(z.enum(creatorPresetCapabilities)).min(1).max(8)
}).strict();
const authorSchema = z.object({
diff --cc apps/daemon/src/creator/service.ts
index 56760dae,56760dae..a8bb5970
--- a/apps/daemon/src/creator/service.ts
+++ b/apps/daemon/src/creator/service.ts
@@@ -192,10 -192,10 +192,7 @@@ export function createCreatorService(in
? {}
: {
requirementService: preset.requirements.service,
-- requirementProvider: preset.requirements.provider,
-- ...(preset.requirements.model === undefined
-- ? {}
-- : { requirementModel: preset.requirements.model })
++ requirementCapabilities: preset.requirements.capabilities
})
}
});
diff --cc apps/daemon/src/creator/stickman/audio-executor.ts
index 2b7b9ccc,b448bbe0..f9e6c2e5
--- a/apps/daemon/src/creator/stickman/audio-executor.ts
+++ b/apps/daemon/src/creator/stickman/audio-executor.ts
@@@ -249,12 -280,10 +280,11 @@@ async function buildAudioTiming
function resolveTtsSelection(stage: CreatorExecutorInput, config: CreatorServicesConfig) {
const provider = stage.job.state.ttsProvider === 'openai'
|| stage.job.state.ttsProvider === 'aliyun'
+ || stage.job.state.ttsProvider === 'edge-tts'
|| stage.job.state.ttsProvider === 'minimax'
+ || stage.job.state.ttsProvider === 'volcengine'
? stage.job.state.ttsProvider
- : config.tts.provider === 'edge-tts'
- ? undefined
- : config.tts.provider;
+ : config.tts.provider;
if (provider === undefined) {
throw new CreatorExecutorError(
'creator_tts_config_missing',
diff --cc apps/daemon/src/creator/stickman/image-executor.ts
index aa037df3,785b59b2..ff11fa6b
--- a/apps/daemon/src/creator/stickman/image-executor.ts
+++ b/apps/daemon/src/creator/stickman/image-executor.ts
@@@ -7,8 -14,9 +14,10 @@@ import sharp from 'sharp'
import type { CreatorServicesConfigStore } from '../../creator-services/config-store.js';
import {
generateImageContents,
- imageGenerationCapabilities
+ imageGenerationCapabilities,
+ type CodexNativeImageRuntime
} from '../../image-generation/provider.js';
++import { resolveCreatorImageSettings } from '../image-settings.js';
import type { CreatorExecutor } from '../executor.js';
import { CreatorExecutorError } from '../executor.js';
import { CreatorProviderRequestLedger } from '../provider-requests.js';
@@@ -225,10 -244,13 +245,17 @@@ export function createStickmanImageExec
...(previousShotImage === undefined ? [] : [previousShotImage.id])
])];
const config = await input.configStore.read();
-- const provider = config.image.provider;
++ const imageSettings = resolveCreatorImageSettings({
++ config,
++ provider: stage.job.state.provider,
++ candidateCount: 1,
++ fallbackCandidateCount: 1,
++ maxCandidateCount: 1
++ });
++ const { provider } = imageSettings;
const quality = readQuality(stage.job.state.quality);
assertReferenceImageSupport(provider, referenceImages.length);
- const model = config.image[provider].model;
- const model = provider === 'codex-native' ? 'codex-native' : config.image[provider].model;
- const codexNativeImagePaths = provider === 'codex-native'
- ? await materializeCodexNativeReferences(referenceImages, stage.workdir)
- : undefined;
++ const model = imageSettings.model;
if (
promptPackArtifact.metadata.contract !== STICKMAN_IMAGE_PROMPT_CONTRACT
|| promptPack.characterReferenceArtifactId !== characterReference.id
@@@ -303,7 -329,11 +333,10 @@@
referenceImages: referenceImages.map(reference => ({
content: reference.content,
mime: reference.mime
- }))
+ })),
- ...(codexNativeImagePaths === undefined ? {} : { codexNativeImagePaths }),
+ ...(input.codexNative === undefined
+ ? {}
- : { codexNative: { ...input.codexNative, cwd: stage.workdir } })
++ : { codexNative: input.codexNative })
});
input.ledger.markSucceeded(ledger.id);
} catch (error) {
@@@ -406,9 -438,31 +440,10 @@@ type StickmanImageCandidateQuality =
detectedText: string[];
};
-async function materializeCodexNativeReferences(
- references: Array<{
- role: string;
- content: Buffer;
- mime: 'image/png' | 'image/jpeg' | 'image/webp';
- }>,
- workdir: string
-): Promise<string[]> {
- return await Promise.all(references.map(async (reference, index) => {
- const extension = reference.mime === 'image/jpeg'
- ? 'jpg'
- : reference.mime === 'image/webp'
- ? 'webp'
- : 'png';
- const safeRole = reference.role.replace(/[^a-z0-9_-]/gi, '-');
- const path = join(workdir, `codex-reference-${String(index + 1).padStart(2, '0')}-${safeRole}.${extension}`);
- await writeFile(path, reference.content);
- return path;
- }));
-}
-
async function inspectStickmanImageCandidate(
path: string,
- tesseractPath?: string
+ tesseractPath?: string,
+ expectedCanvas: StickmanCanvas = stickmanCanvasForRatio('16:9')
): Promise<StickmanImageCandidateQuality> {
let metadata: Awaited<ReturnType<typeof sharp.prototype.metadata>>;
let stats: Awaited<ReturnType<typeof sharp.prototype.stats>>;
@@@ -487,7 -544,7 +525,7 @@@ function assertReferenceImageSupport(pr
if (capabilities.supportsReferenceImage && capabilities.maxReferenceImages >= count) return;
throw new CreatorExecutorError(
'creator_stickman_image_provider_unsupported',
- `当前生图服务 ${provider} 不支持任务需要的 ${count} 张参考图。请在 AI 服务 -> 生图服务中切换到支持多参考图的 OpenAI 或 Gemini 服务`
- `The ${provider} image provider does not support the ${count} reference images required by this job. Use Codex (subscription), OpenAI, or Gemini with multi-reference support`
++ `The ${provider} image provider does not support the ${count} reference images required by this job. Use local Codex image generation, OpenAI, or Gemini with multi-reference support`
);
}
diff --cc apps/daemon/src/creator/templates/cover-actions.ts
index 90176b33,4edd0948..c0c86924
--- a/apps/daemon/src/creator/templates/cover-actions.ts
+++ b/apps/daemon/src/creator/templates/cover-actions.ts
@@@ -6,6 -6,6 +6,11 @@@ import type
import type { CreatorServicesConfigStore } from '../../creator-services/config-store.js';
import type { CreatorCommandDispatcher } from '../command-dispatcher.js';
import type { CreatorService } from '../service.js';
++import {
++ imageProviderConfigured,
++ readImageProvider
++} from '../image-settings.js';
++import { imageGenerationCapabilities } from '../../image-generation/provider.js';
export type CoverWorkflow = ReturnType<typeof createCoverWorkflow>;
@@@ -48,7 -48,7 +53,7 @@@ export function createCoverWorkflow(inp
throw error;
}
const config = await input.configStore.read();
-- const provider = readProvider(job.state.provider, config.image.provider);
++ const provider = readImageProvider(job.state.provider, config.image.provider);
if (!hasImageCredentials(config, provider)) {
setConfigurationNeeded(input.creator, job.id, {
code: 'creator_image_config_missing',
@@@ -168,7 -168,7 +173,7 @@@ export class CoverWorkflowError extend
}
export function supportsReferenceImage(provider: ImageGenerationProvider): boolean {
-- return provider === 'openai' || provider === 'gemini';
++ return imageGenerationCapabilities(provider).supportsReferenceImage;
}
function validateYoutubeSource(job: CreatorJob): void {
@@@ -247,20 -247,25 +252,7 @@@ function hasImageCredentials
config: Awaited<ReturnType<CreatorServicesConfigStore['read']>>,
provider: ImageGenerationProvider
): boolean {
- if (provider === 'codex-native') return true;
-- if (provider === 'kling') {
-- return config.image.kling.accessKey.trim().length > 0
-- && config.image.kling.secretKey.trim().length > 0;
-- }
-- return config.image[provider].apiKey.trim().length > 0;
--}
--
--function readProvider(
-- value: unknown,
-- fallback: ImageGenerationProvider
--): ImageGenerationProvider {
- return value === 'openai' || value === 'jimeng' || value === 'kling' || value === 'gemini'
- return value === 'openai'
- || value === 'jimeng'
- || value === 'kling'
- || value === 'gemini'
- || value === 'codex-native'
-- ? value
-- : fallback;
++ return imageProviderConfigured(config, provider);
}
function setConfigurationNeeded(
diff --cc apps/daemon/src/creator/templates/image-generation.ts
index b8c2cdff,3d2c0911..7138a78a
--- a/apps/daemon/src/creator/templates/image-generation.ts
+++ b/apps/daemon/src/creator/templates/image-generation.ts
@@@ -22,10 -22,10 +22,10 @@@ function createImageGenerationTemplateD
renderer: 'image-generation',
inputSchema: z.object({
prompt: z.string().max(creatorPromptMaxLength).default(''),
- provider: z.enum(['openai', 'jimeng', 'kling', 'gemini']).default('openai'),
- provider: z.enum(['openai', 'jimeng', 'kling', 'gemini', 'codex-native']).default('openai'),
++ provider: z.enum(['openai', 'jimeng', 'kling', 'gemini', 'codex-native']).optional(),
size: z.enum(['1024x1024', '1536x1024', '1024x1536']).default('1024x1024'),
quality: z.enum(['low', 'medium', 'high']).default('medium'),
-- candidateCount: z.number().int().min(1).max(4).default(2),
++ candidateCount: z.number().int().min(1).max(4).optional(),
...(supportsReferenceImage
? { referenceImageArtifactId: z.string().nullable().default(null) }
: {}),
diff --cc apps/daemon/src/creator/templates/stickman-video-actions.ts
index 7d280fdc,3bfcd860..9e6b8b35
--- a/apps/daemon/src/creator/templates/stickman-video-actions.ts
+++ b/apps/daemon/src/creator/templates/stickman-video-actions.ts
@@@ -13,6 -13,6 +13,7 @@@ import
} from '../provider-requests.js';
import type { CreatorRepository } from '../repository.js';
import { CreatorServiceError, type CreatorService } from '../service.js';
++import { resolveCreatorImageSettings } from '../image-settings.js';
import {
stickmanScriptManifestSchema,
stickmanShotSpecSchema
@@@ -424,10 -425,10 +426,15 @@@ export function createStickmanVideoWork
};
}
const config = await input.configStore.read();
-- const provider = config.image.provider;
++ const settings = resolveCreatorImageSettings({
++ config,
++ provider: job.state.provider,
++ fallbackCandidateCount: 1,
++ maxCandidateCount: 1
++ });
return {
-- provider,
- model: config.image[provider].model,
- model: provider === 'codex-native' ? 'codex-native' : config.image[provider].model,
++ provider: settings.provider,
++ model: settings.model,
quality: typeof job.state.quality === 'string' ? job.state.quality : 'medium'
};
}
@@@ -443,8 -444,8 +450,9 @@@
const config = await input.configStore.read();
const provider = job.state.ttsProvider === 'openai'
|| job.state.ttsProvider === 'aliyun'
+ || job.state.ttsProvider === 'edge-tts'
|| job.state.ttsProvider === 'minimax'
+ || job.state.ttsProvider === 'volcengine'
? job.state.ttsProvider
: config.tts.provider;
if (provider === 'edge-tts') {
diff --cc apps/daemon/src/creator/templates/stickman-video.ts
index ad843a9b,a497f522..f57b7cdb
--- a/apps/daemon/src/creator/templates/stickman-video.ts
+++ b/apps/daemon/src/creator/templates/stickman-video.ts
@@@ -25,6 -30,40 +30,40 @@@ const action =
allowedStages: string[]
): CreatorTemplateAction => ({ id, inputSchema: schema as never, allowedStages });
+ const stickmanInputSchema = z.preprocess(value => {
+ if (value === null || typeof value !== 'object' || Array.isArray(value)) return value;
+ const record = value as Record<string, unknown>;
+ if (record.outputPreset !== 'youtube-shorts') return value;
+ return {
+ ...record,
+ ...stickmanOutputPresetDefaults('youtube-shorts')
+ };
+ }, z.object({
+ sourceType: z.enum(['url', 'text']).default('url'),
+ sourceUrl: z.string().default(''),
+ sourceText: z.string().max(50_000).default(''),
+ topic: z.string().default(''),
+ characterAsset: visualAssetRef.default({
+ assetId: 'stickman.character.default',
+ revision: 1
+ }),
+ styleAsset: visualAssetRef.default({
+ assetId: 'stickman.style.paper-pencil',
+ revision: 1
+ }),
+ outputPreset: z.enum(stickmanOutputPresets).default('landscape'),
+ ratio: z.enum(stickmanRatios).default('16:9'),
+ targetDurationSeconds: z.number().positive().max(600).default(30),
+ sourceLanguage: z.string().default('auto'),
+ targetLanguage: z.string().default('zh-CN'),
- ttsProvider: z.enum(['openai', 'aliyun', 'edge-tts', 'minimax']).optional(),
++ ttsProvider: z.enum(['openai', 'aliyun', 'edge-tts', 'minimax', 'volcengine']).optional(),
+ ttsModel: z.string().optional(),
+ voiceCode: z.string().optional(),
+ voiceName: z.string().optional(),
+ workflowTarget: workflowTarget.default('script_ready'),
+ currentStage: z.string().nullable().default(null)
+ }).passthrough());
+
const stage = (
definition: Omit<CreatorTemplateStage, 'allowedJobStatuses' | 'jobCompletionPolicy'>
& { final?: boolean }
diff --cc apps/daemon/src/creator/templates/video-translation-actions.ts
index a274955c,5ef3311a..75102868
--- a/apps/daemon/src/creator/templates/video-translation-actions.ts
+++ b/apps/daemon/src/creator/templates/video-translation-actions.ts
@@@ -20,7 -20,7 +20,14 @@@ export function createVideoTranslationW
validateSource(job);
if (job.artifacts.some(artifact => artifact.id === job.state.importedTargetSubtitleId && artifact.kind === 'target_subtitle' && artifact.status === 'completed')) return;
const config = await input.configStore.read();
-- if (!config.llm.apiKey) {
++ if (
++ config.llm.source === 'custom'
++ && (
++ !config.llm.baseUrl.trim()
++ || !config.llm.model.trim()
++ || !config.llm.apiKey.trim()
++ )
++ ) {
setConfigurationNeeded(input.creator, job.id, {
code: 'creator_llm_config_missing',
message: '请先完成文本翻译模型配置',
diff --cc apps/daemon/src/image-generation/provider.ts
index b591af2b,ee1e912d..2212d3b3
--- a/apps/daemon/src/image-generation/provider.ts
+++ b/apps/daemon/src/image-generation/provider.ts
@@@ -3,6 -3,11 +3,11 @@@ import type
CreatorServicesConfig,
ImageGenerationAsset
} from '@opencreator/protocol';
+ import {
- CodexNativeImageError,
- generateCodexNativeImage,
- type CodexNativeImageInput
-} from './codex-native.js';
++ LocalCodexProviderError,
++ readLocalCodexProvider,
++ type LocalCodexProvider
++} from '../codex/local-provider.js';
import { createKlingAuthorization } from '../creator-services/kling-auth.js';
import {
appendEndpointPath,
@@@ -22,6 -27,11 +27,11 @@@ export type GeneratedImageContent =
mime: ImageGenerationAsset['mime'];
};
-export type CodexNativeImageRuntime = Pick<
- CodexNativeImageInput,
- 'codexBin' | 'codexHome' | 'cwd' | 'createHost'
->;
++export type CodexNativeImageRuntime = {
++ codexHome: string;
++ readProvider?: () => Promise<LocalCodexProvider>;
++};
+
export type ImageGenerationCapabilities = {
supportsReferenceImage: boolean;
maxReferenceImages: number;
@@@ -54,6 -64,8 +64,7 @@@ export async function generateImageCont
signal?: AbortSignal;
referenceImage?: GeneratedImageContent;
referenceImages?: GeneratedImageContent[];
- codexNativeImagePaths?: string[];
+ codexNative?: CodexNativeImageRuntime;
} = {}
): Promise<{ model: string; contents: GeneratedImageContent[] }> {
const referenceImages = options.referenceImages
@@@ -76,6 -88,38 +87,39 @@@
: `The ${request.provider} image provider does not support reference images`
);
}
+ if (request.provider === 'codex-native') {
+ if (request.count !== 1) {
+ throw new ImageGenerationProviderError(
+ 'unsupported_capability',
+ 'The codex-native image provider supports exactly one image per request'
+ );
+ }
+ if (options.codexNative === undefined) {
+ throw new ImageGenerationProviderError(
+ 'config_missing',
+ 'Configure the local Codex executable and CODEX_HOME before generating images'
+ );
+ }
+ try {
- const generated = await generateCodexNativeImage({
- ...options.codexNative,
- prompt: request.prompt,
- size: request.size,
- quality: request.quality,
- ...(options.codexNativeImagePaths === undefined
- ? {}
- : { imagePaths: options.codexNativeImagePaths }),
- signal: controller.signal
- });
- return { model: generated.model, contents: [generated] };
++ const provider = await (
++ options.codexNative.readProvider?.()
++ ?? readLocalCodexProvider({ codexHome: options.codexNative.codexHome })
++ );
++ return await generateOpenAiImages(
++ request,
++ config,
++ controller.signal,
++ referenceImages,
++ options.fetchImpl,
++ provider
++ );
+ } catch (error) {
- if (error instanceof CodexNativeImageError) {
- throw new ImageGenerationProviderError(error.code, error.message);
++ if (error instanceof LocalCodexProviderError) {
++ throw new ImageGenerationProviderError('config_missing', error.message);
+ }
+ throw error;
+ }
+ }
if (request.provider === 'gemini') {
return await generateGeminiImages(
request,
@@@ -113,9 -157,9 +157,11 @@@ async function generateOpenAiImages
config: CreatorServicesConfig,
signal: AbortSignal,
referenceImages: GeneratedImageContent[],
-- fetchImpl?: typeof fetch
++ fetchImpl?: typeof fetch,
++ providerOverride?: LocalCodexProvider
) {
-- const provider = request.provider === 'jimeng' ? config.image.jimeng : config.image.openai;
++ const provider = providerOverride
++ ?? (request.provider === 'jimeng' ? config.image.jimeng : config.image.openai);
if (!provider.apiKey.trim()) missingConfig(request.provider);
const model = provider.model.trim()
|| (request.provider === 'jimeng' ? 'doubao-seedream-4-0-250828' : 'gpt-image-1');
@@@ -144,7 -188,7 +190,7 @@@
model,
prompt: request.prompt.trim(),
size: request.size,
-- ...(request.provider === 'openai' ? { quality: request.quality } : {}),
++ ...(request.provider === 'jimeng' ? {} : { quality: request.quality }),
n: request.count
}),
proxy: config.proxy.trim(),
diff --cc apps/daemon/src/main.ts
index 5c7b4d28,44c6a7e9..d35539a2
--- a/apps/daemon/src/main.ts
+++ b/apps/daemon/src/main.ts
@@@ -1,4 -1,4 +1,4 @@@
--import { mkdirSync, readFileSync, readdirSync, statSync } from 'node:fs';
++import { mkdirSync, readFileSync, statSync } from 'node:fs';
import {
rename,
rm,
@@@ -78,8 -79,8 +78,11 @@@ async function main(): Promise<void>
} = paths;
const codexBin = environment.codexBin ?? 'codex';
const codexHome = resolveCodexHome({ isolatedHome: paths.codexHome }).path;
-- if (environment.codexHome === undefined && !directoryHasEntries(codexHome)) {
-- createCodexIsolatedHome(resolveCodexHome().path, codexHome);
++ const localCodexHome = environment.codexHome === undefined
++ ? resolveCodexHome().path
++ : codexHome;
++ if (environment.codexHome === undefined) {
++ createCodexIsolatedHome(localCodexHome, codexHome);
}
readOpenCreatorConfig(configFile);
mkdirSync(dataDir, { recursive: true });
@@@ -158,7 -159,7 +161,8 @@@
credentialsFile,
runtimeDir,
creatorDir,
-- codexHome
++ codexHome,
++ localCodexHome
}));
const address = await server.listen({ host: '127.0.0.1', port: 0 });
capabilityResolution.startBackgroundRefresh();
@@@ -192,14 -193,14 +196,6 @@@
}
}
--function directoryHasEntries(path: string): boolean {
-- try {
-- return statSync(path).isDirectory() && readdirSync(path).length > 0;
-- } catch {
-- return false;
-- }
--}
--
function requiresProbe(): boolean {
return process.env.OPENCREATOR_REQUIRE_CODEX_PROBE === '1';
}
diff --cc apps/daemon/test/integration/creator-krillin-cli-runner.test.ts
index db011326,330935a4..89482f34
--- a/apps/daemon/test/integration/creator-krillin-cli-runner.test.ts
+++ b/apps/daemon/test/integration/creator-krillin-cli-runner.test.ts
@@@ -105,39 -105,6 +105,55 @@@ describe('KrillinAI CLI runner', () =>
});
});
++ it('can route Krillin LLM calls through the local Codex gateway', () => {
++ const config = createDefaultCreatorServicesConfig();
++ const value = parse(createKrillinConfigToml(config, {
++ baseUrl: 'http://127.0.0.1:4321/internal/krillin-llm/v1',
++ apiKey: 'task-token',
++ model: 'codex'
++ })) as { llm: Record<string, unknown> };
++
++ expect(value.llm).toEqual({
++ base_url: 'http://127.0.0.1:4321/internal/krillin-llm/v1',
++ api_key: 'task-token',
++ model: 'codex',
++ json: false
++ });
++ });
++
+ it('bridges Volcengine ASR and TTS credentials into KrillinAI config', () => {
+ const config = createDefaultCreatorServicesConfig();
+ config.transcription.provider = 'volcengine';
+ config.transcription.volcengine.appId = 'asr-app';
+ config.transcription.volcengine.accessToken = 'asr-token';
+ config.tts.provider = 'volcengine';
+ config.tts.volcengine.appId = 'tts-app';
+ config.tts.volcengine.accessToken = 'tts-token';
+
+ const value = parse(createKrillinConfigToml(config)) as {
+ transcribe: { provider: string; volcengine: Record<string, string> };
+ tts: { provider: string; volcengine: Record<string, string> };
+ };
+
+ expect(value.transcribe).toMatchObject({
+ provider: 'volcengine',
+ volcengine: {
+ app_id: 'asr-app',
+ access_token: 'asr-token',
+ resource_id: 'volc.seedasr.auc'
+ }
+ });
+ expect(value.tts).toMatchObject({
+ provider: 'volcengine',
+ volcengine: {
+ app_id: 'tts-app',
+ access_token: 'tts-token',
+ cluster: 'volcano_tts',
+ default_voice_id: 'BV001_streaming'
+ }
+ });
+ });
+
it('recovers only the known Windows ASS drive-letter failure with the auto-video relative-path command', async () => {
tempDir = mkdtempSync(join(tmpdir(), 'creator-krillin-windows-ass-'));
const resourceRoot = join(tempDir, 'runtime');
diff --cc apps/daemon/test/integration/image-generation-api.test.ts
index 86121f91,fb63dfd9..b5584a06
--- a/apps/daemon/test/integration/image-generation-api.test.ts
+++ b/apps/daemon/test/integration/image-generation-api.test.ts
@@@ -77,6 -82,53 +77,53 @@@ describe('image generation API', () =>
.toEqual(['0.png', 'result.json']);
});
- it('generates and stores a Codex native image without using a remote fetcher', async () => {
++ it('generates and stores an image through the local Codex provider', async () => {
+ const config = createDefaultCreatorServicesConfig();
+ config.image.provider = 'codex-native';
- const codexHome = join(dataDir, 'codex-home');
- const savedPath = join(codexHome, 'generated_images', 'native.png');
+ const image = Buffer.concat([
+ Buffer.from([0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a]),
+ Buffer.from('codex-native-image')
+ ]);
- await mkdir(join(codexHome, 'generated_images'), { recursive: true });
- await writeFile(savedPath, image);
- const createHost = fakeNativeHost(savedPath);
- const fetchImpl = vi.fn() as typeof fetch;
++ const fetchMock = vi.fn(async (_input: RequestInfo | URL, _init?: RequestInit) => new Response(JSON.stringify({
++ data: [{ b64_json: image.toString('base64') }]
++ }), { status: 200 }));
+ await registerImageGenerationRoutes(server, createImageGenerationService({
+ dataDir,
+ configStore: createConfigStore(config),
- fetchImpl,
++ fetchImpl: fetchMock as typeof fetch,
+ codexNative: {
- codexBin: 'codex',
- codexHome,
- cwd: dataDir,
- createHost
++ codexHome: join(dataDir, 'codex-home'),
++ readProvider: async () => ({
++ baseUrl: 'https://forward.example.test/v1',
++ apiKey: 'local-codex-secret',
++ model: 'gpt-image-1'
++ })
+ },
+ createId: () => 'codex_native_1234'
+ }));
+
+ const generated = await server.inject({
+ method: 'POST',
+ url: '/image-generation/results',
+ payload: { prompt: 'An original orange cat', provider: 'codex-native', size: '1024x1024', quality: 'medium', count: 1 }
+ });
+
+ expect(generated.statusCode).toBe(201);
+ expect(generated.json().result).toMatchObject({
+ provider: 'codex-native',
- model: 'codex-native',
++ model: 'gpt-image-1',
+ images: [{ mime: 'image/png', size: image.length }]
+ });
- expect(fetchImpl).not.toHaveBeenCalled();
++ expect(String(fetchMock.mock.calls[0]?.[0]))
++ .toBe('https://forward.example.test/v1/images/generations');
+ const content = await server.inject({
+ method: 'GET',
+ url: '/image-generation/results/codex_native_1234/content/0'
+ });
+ expect(content.statusCode).toBe(200);
+ expect(content.rawPayload).toEqual(image);
+ });
+
it('adds v1 to an OpenAI-compatible image provider path without a version', async () => {
const config = createDefaultCreatorServicesConfig();
config.image.openai.apiKey = 'sk-image-test';
diff --cc apps/daemon/test/unit/codex-local-provider.test.ts
index 00000000,00000000..c601b625
new file mode 100644
--- /dev/null
+++ b/apps/daemon/test/unit/codex-local-provider.test.ts
@@@ -1,0 -1,0 +1,89 @@@
++import { mkdir, mkdtemp, rm, writeFile } from 'node:fs/promises';
++import { tmpdir } from 'node:os';
++import { join } from 'node:path';
++import { afterEach, describe, expect, it } from 'vitest';
++import {
++ LocalCodexProviderError,
++ readLocalCodexProvider
++} from '../../src/codex/local-provider.js';
++
++describe('local Codex provider', () => {
++ let root = '';
++
++ afterEach(async () => {
++ if (root) await rm(root, { recursive: true, force: true });
++ root = '';
++ });
++
++ it('reads the selected provider base URL and bearer token', async () => {
++ root = await codexHome([
++ 'model = "gpt-5.6-sol"',
++ 'model_provider = "gateway"',
++ '',
++ '[model_providers.gateway]',
++ 'base_url = "https://forward.example.test/v1"',
++ 'experimental_bearer_token = "gateway-secret"'
++ ]);
++
++ await expect(readLocalCodexProvider({ codexHome: root })).resolves.toEqual({
++ baseUrl: 'https://forward.example.test/v1',
++ apiKey: 'gateway-secret',
++ model: 'gpt-image-1'
++ });
++ });
++
++ it('supports provider environment keys and configured image models', async () => {
++ root = await codexHome([
++ 'model = "gpt-image-2"',
++ 'model_provider = "gateway"',
++ '',
++ '[model_providers.gateway]',
++ 'base_url = "https://forward.example.test/v1"',
++ 'env_key = "TEST_CODEX_PROVIDER_KEY"'
++ ]);
++
++ await expect(readLocalCodexProvider({
++ codexHome: root,
++ env: { TEST_CODEX_PROVIDER_KEY: 'environment-secret' }
++ })).resolves.toEqual({
++ baseUrl: 'https://forward.example.test/v1',
++ apiKey: 'environment-secret',
++ model: 'gpt-image-2'
++ });
++ });
++
++ it('uses the API key credential stored by Codex', async () => {
++ root = await codexHome([
++ 'model = "text-model"',
++ 'openai_base_url = "https://api.example.test/v1"'
++ ]);
++ await writeFile(join(root, 'auth.json'), JSON.stringify({
++ auth_mode: 'apikey',
++ OPENAI_API_KEY: 'stored-secret'
++ }));
++
++ await expect(readLocalCodexProvider({ codexHome: root })).resolves.toEqual({
++ baseUrl: 'https://api.example.test/v1',
++ apiKey: 'stored-secret',
++ model: 'gpt-image-1'
++ });
++ });
++
++ it('does not treat a ChatGPT login token as an image API key', async () => {
++ root = await codexHome(['model = "gpt-5"']);
++ await writeFile(join(root, 'auth.json'), JSON.stringify({
++ auth_mode: 'chatgpt',
++ tokens: { access_token: 'oauth-secret' }
++ }));
++
++ await expect(readLocalCodexProvider({ codexHome: root }))
++ .rejects.toBeInstanceOf(LocalCodexProviderError);
++ });
++
++ async function codexHome(lines: string[]): Promise<string> {
++ const path = await mkdtemp(join(tmpdir(), 'opencreator-local-provider-'));
++ await mkdir(path, { recursive: true });
++ await writeFile(join(path, 'config.toml'), `${lines.join('\n')}\n`);
++ return path;
++ }
++});
diff --cc apps/daemon/test/unit/codex-probe-home.test.ts
index c694d168,c694d168..8983934f
--- a/apps/daemon/test/unit/codex-probe-home.test.ts
+++ b/apps/daemon/test/unit/codex-probe-home.test.ts
@@@ -23,6 -23,6 +23,41 @@@ afterEach(() =>
});
describe('Codex Probe 临时 Home', () => {
++ it('refreshes the isolated provider from the local Codex home', () => {
++ tempDir = mkdtempSync(join(tmpdir(), 'opencreator-isolated-provider-test-'));
++ const sourceHome = join(tempDir, 'source');
++ const isolatedPath = join(tempDir, 'isolated');
++ mkdirSync(sourceHome, { recursive: true });
++ mkdirSync(isolatedPath, { recursive: true });
++ writeFileSync(join(sourceHome, 'config.toml'), [
++ 'model = "gpt-5.6-sol"',
++ 'model_provider = "gateway"',
++ '',
++ '[model_providers.gateway]',
++ 'base_url = "https://forward.example.test/v1"',
++ 'experimental_bearer_token = "provider-secret"',
++ ''
++ ].join('\n'));
++ writeFileSync(join(isolatedPath, 'config.toml'), [
++ 'model = "stale-model"',
++ 'openai_base_url = "https://stale.example.test/v1"',
++ ''
++ ].join('\n'));
++
++ createCodexIsolatedHome(sourceHome, isolatedPath);
++
++ expect(parse(readFileSync(join(isolatedPath, 'config.toml'), 'utf8'))).toMatchObject({
++ model: 'gpt-5.6-sol',
++ model_provider: 'gateway',
++ model_providers: {
++ gateway: {
++ base_url: 'https://forward.example.test/v1',
++ experimental_bearer_token: 'provider-secret'
++ }
++ }
++ });
++ });
++
it('为知识会话保留隔离 Home 中的 Codex rollout', () => {
tempDir = mkdtempSync(join(tmpdir(), 'opencreator-isolated-home-test-'));
const sourceHome = join(tempDir, 'source');
diff --cc apps/daemon/test/unit/codex-provider-config.test.ts
index 9ac5a976,9ac5a976..e1dd229d
--- a/apps/daemon/test/unit/codex-provider-config.test.ts
+++ b/apps/daemon/test/unit/codex-provider-config.test.ts
@@@ -6,6 -6,6 +6,46 @@@ import
} from '../../src/codex/provider-config.js';
describe('Codex provider configuration', () => {
++ it('recognizes a selected provider bearer token without Codex account login', async () => {
++ const client: RestartableCodexAppServerRequestClient = {
++ async request<Result>(method: string): Promise<Result> {
++ if (method === 'config/read') {
++ return {
++ config: {
++ model: 'gpt-5.6-sol',
++ model_provider: 'gateway',
++ model_providers: {
++ gateway: {
++ base_url: 'https://forward.example.test/v1',
++ experimental_bearer_token: 'provider-secret'
++ }
++ }
++ },
++ layers: [{ name: { type: 'user', profile: null }, version: 'v1' }]
++ } as Result;
++ }
++ if (method === 'account/read') {
++ return { account: null, requiresOpenaiAuth: false } as Result;
++ }
++ throw new Error(`Unexpected method: ${method}`);
++ },
++ restart: vi.fn(async () => undefined),
++ close: async () => undefined
++ };
++ const service = createCodexProviderConfigService({
++ client,
++ readiness: { refresh: vi.fn() } as never
++ });
++
++ await expect(service.read()).resolves.toEqual({
++ baseUrl: 'https://forward.example.test/v1',
++ model: 'gpt-5.6-sol',
++ apiKeyConfigured: true,
++ authentication: 'api_key',
++ configVersion: 'v1'
++ });
++ });
++
it('writes provider settings, stores the API key through account login and restarts consumers', async () => {
const calls: Array<{ method: string; params: unknown }> = [];
let config: Record<string, unknown> = {
diff --cc apps/daemon/test/unit/creator-cover-workflow.test.ts
index 804f4934,804f4934..e776044c
--- a/apps/daemon/test/unit/creator-cover-workflow.test.ts
+++ b/apps/daemon/test/unit/creator-cover-workflow.test.ts
@@@ -245,6 -245,6 +245,7 @@@ function setup(state: Record<string, Cr
receipts: createCreatorAgentRepository(db)
});
const config = createDefaultCreatorServicesConfig();
++ config.image.openai.baseUrl = 'https://api.openai.com/v1';
const readConfig = vi.fn(async (): Promise<CreatorServicesConfig> => config);
const workflow = createCoverWorkflow({
creator: service,
diff --cc apps/daemon/test/unit/creator-image-executor.test.ts
index 79db344a,5ce433c1..7b42ffd3
--- a/apps/daemon/test/unit/creator-image-executor.test.ts
+++ b/apps/daemon/test/unit/creator-image-executor.test.ts
@@@ -92,6 -92,49 +92,56 @@@ describe('creator image executor', () =
}
);
+ it('runs exactly one candidate for codex-native', async () => {
+ tempDir = await mkdtemp(join(tmpdir(), 'creator-image-executor-codex-native-'));
+ const config = createDefaultCreatorServicesConfig();
+ const generate = vi.fn(async (request: { provider: ImageGenerationProvider }) => ({
+ model: `${request.provider}-model`,
+ contents: [{ content: png('image-codex-native'), mime: 'image/png' as const }]
+ }));
+ const executor = createImageExecutor({
+ configStore: { read: async () => config },
+ generate: generate as never
+ });
+
+ const result = await executor.run(stageInput({
+ provider: 'codex-native',
+ candidateCount: 1
+ }));
+
+ expect(generate).toHaveBeenCalledTimes(1);
+ expect(generate).toHaveBeenCalledWith(
+ expect.objectContaining({ provider: 'codex-native', count: 1 }),
+ config,
+ expect.objectContaining({ signal: expect.any(AbortSignal) })
+ );
+ expect(result.outputs).toHaveLength(1);
+ });
+
- it('rejects multiple candidates for codex-native before starting a host', async () => {
++ it('normalizes inherited candidate counts for codex-native', async () => {
+ tempDir = await mkdtemp(join(tmpdir(), 'creator-image-executor-codex-native-many-'));
- const generate = vi.fn();
++ const config = createDefaultCreatorServicesConfig();
++ config.image.provider = 'codex-native';
++ const generate = vi.fn(async () => ({
++ model: 'codex-native',
++ contents: [{ content: png('normalized-codex-image'), mime: 'image/png' as const }]
++ }));
+ const executor = createImageExecutor({
- configStore: { read: async () => createDefaultCreatorServicesConfig() },
++ configStore: { read: async () => config },
+ generate: generate as never
+ });
+
- await expect(executor.run(stageInput({
- provider: 'codex-native',
- candidateCount: 2
- }))).rejects.toMatchObject({
- code: 'unsupported_capability'
- });
- expect(generate).not.toHaveBeenCalled();
++ const stage = stageInput({ candidateCount: 2 });
++ delete stage.job.state.provider;
++ await executor.run(stage);
++
++ expect(generate).toHaveBeenCalledWith(
++ expect.objectContaining({ provider: 'codex-native', count: 1 }),
++ config,
++ expect.any(Object)
++ );
+ });
+
it('keeps successful candidates when another candidate fails', async () => {
tempDir = await mkdtemp(join(tmpdir(), 'creator-image-executor-partial-'));
let candidate = 0;
diff --cc apps/daemon/test/unit/creator-preflight.test.ts
index b3c10a5f,00000000..06eb251c
mode 100644,000000..100644
--- a/apps/daemon/test/unit/creator-preflight.test.ts
+++ b/apps/daemon/test/unit/creator-preflight.test.ts
@@@ -1,245 -1,0 +1,292 @@@
+import { mkdtemp, rm, writeFile } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { afterEach, describe, expect, it } from 'vitest';
+import { createDefaultCreatorServicesConfig, type CreatorJob, type CreatorJson } from '@opencreator/protocol';
+import { createCreatorPreflight } from '../../src/creator/preflight.js';
+import { createImageGenerationTemplate } from '../../src/creator/templates/image-generation.js';
+import { createVideoDownloadTemplate } from '../../src/creator/templates/video-download.js';
+import { createStickmanVideoTemplate } from '../../src/creator/templates/stickman-video.js';
+import { createCoverTemplate } from '../../src/creator/templates/cover.js';
+import { createSmartDubbingTemplate } from '../../src/creator/templates/smart-dubbing.js';
+import { createVideoTranslationTemplate } from '../../src/creator/templates/video-translation.js';
+import { createKrillinCreatorServicesCapabilities } from '../../src/creator/krillin/capabilities.js';
+
+let root = '';
+
+afterEach(async () => {
+ if (root) await rm(root, { recursive: true, force: true });
+ root = '';
+});
+
+describe('creator preflight', () => {
+ it('blocks a stage with missing provider credentials and provides a settings repair', async () => {
+ root = await mkdtemp(join(tmpdir(), 'creator-preflight-'));
+ const config = createDefaultCreatorServicesConfig();
+ const job = fakeJob('image-generation', { provider: 'openai', prompt: 'test' });
+ const result = await createCreatorPreflight({
+ configStore: { read: async () => config },
+ readCapabilities: () => createKrillinCreatorServicesCapabilities('win32', 'x64'),
+ resourceRoot: join(root, 'runtime'),
+ jobsRoot: join(root, 'jobs'),
+ executorIds: ['image']
+ }).check(job, createImageGenerationTemplate().stages[0]!);
+
+ expect(result.canStart).toBe(false);
+ expect(result.blocked).toEqual(expect.arrayContaining([
+ expect.objectContaining({
+ id: 'image-provider',
+ repair: expect.objectContaining({ deepLink: '#/settings?tab=ai-services&section=image' })
+ })
+ ]));
+ });
+
+ it('reports local dependency failures before creating a download stage', async () => {
+ root = await mkdtemp(join(tmpdir(), 'creator-preflight-'));
+ const job = fakeJob('video-download', { sourceUrl: 'https://youtu.be/example' });
+ const result = await createCreatorPreflight({
+ configStore: { read: async () => createDefaultCreatorServicesConfig() },
+ readCapabilities: () => createKrillinCreatorServicesCapabilities('win32', 'x64'),
+ resourceRoot: join(root, 'runtime'),
+ jobsRoot: join(root, 'jobs'),
+ executorIds: ['download'],
+ validateRuntimeAssets: true
+ }).check(job, createVideoDownloadTemplate().stages[0]!);
+
+ expect(result.canStart).toBe(false);
+ expect(result.blocked.map(item => item.id)).toEqual(expect.arrayContaining(['ffmpeg', 'ffprobe', 'yt-dlp']));
+ expect(result.blocked.every(item => item.repair.label.length > 0)).toBe(true);
+ });
+
+ it('blocks a reference image when the configured provider cannot edit images', async () => {
+ root = await mkdtemp(join(tmpdir(), 'creator-preflight-'));
+ const referencePath = join(root, 'reference.png');
+ await writeFile(referencePath, 'image');
+ const config = createDefaultCreatorServicesConfig();
+ config.image.jimeng.apiKey = 'test-key';
+ const job = fakeJob('image-generation', {
+ provider: 'jimeng',
+ prompt: 'test',
+ referenceImageArtifactId: 'reference-image'
+ });
+ job.artifacts.push({
+ id: 'reference-image',
+ jobId: job.id,
+ kind: 'reference_image',
+ status: 'completed',
+ version: 1,
+ path: referencePath,
+ scopeKey: null,
+ inputFingerprint: null,
+ sha256: null,
+ sourceArtifactIds: [],
+ metadata: {},
+ createdAt: new Date(0).toISOString()
+ });
+
+ const result = await createCreatorPreflight({
+ configStore: { read: async () => config },
+ readCapabilities: () => createKrillinCreatorServicesCapabilities('win32', 'x64'),
+ resourceRoot: join(root, 'runtime'),
+ jobsRoot: join(root, 'jobs'),
+ executorIds: ['image']
+ }).check(job, createImageGenerationTemplate().stages[0]!);
+
+ expect(result.blocked).toEqual(expect.arrayContaining([
+ expect.objectContaining({ id: 'reference-image-capability' })
+ ]));
+ });
+
++ it('accepts Codex subscription image generation without API credentials', async () => {
++ root = await mkdtemp(join(tmpdir(), 'creator-preflight-'));
++ const config = createDefaultCreatorServicesConfig();
++ config.image.provider = 'codex-native';
++ const stage = createStickmanVideoTemplate().stages.find(candidate => candidate.id === 'images')!;
++ const result = await createCreatorPreflight({
++ configStore: { read: async () => config },
++ readCapabilities: () => createKrillinCreatorServicesCapabilities('win32', 'x64'),
++ resourceRoot: join(root, 'runtime'),
++ jobsRoot: join(root, 'jobs'),
++ executorIds: ['stickman-image'],
++ validateRuntimeAssets: false
++ }).check(fakeJob('stickman-video', { provider: 'codex-native' }), stage);
++
++ expect(result.blocked.map(item => item.id)).not.toContain('image-provider');
++ expect(result.ready).toEqual(expect.arrayContaining([
++ expect.objectContaining({ id: 'image-provider', executionMode: 'local' })
++ ]));
++ });
++
+ it.each([
+ ['source-brief', 'stickman-content', 'llm'],
+ ['narration', 'stickman-audio', 'tts'],
+ ['images', 'stickman-image', 'image-provider'],
+ ['render-clean', 'stickman-remotion', 'ffprobe']
+ ] as const)('checks the real Stickman %s executor requirements', async (stageId, executor, blockedId) => {
+ root = await mkdtemp(join(tmpdir(), 'creator-preflight-'));
+ const stage = createStickmanVideoTemplate().stages.find(candidate => candidate.id === stageId)!;
++ const config = createDefaultCreatorServicesConfig();
++ if (blockedId === 'image-provider') config.image.provider = 'openai';
+ const result = await createCreatorPreflight({
- configStore: { read: async () => createDefaultCreatorServicesConfig() },
++ configStore: { read: async () => config },
+ readCapabilities: () => createKrillinCreatorServicesCapabilities('win32', 'x64'),
+ resourceRoot: join(root, 'runtime'),
+ jobsRoot: join(root, 'jobs'),
+ executorIds: [executor]
+ }).check(fakeJob('stickman-video', {}), stage);
+
+ expect(result.blocked.map(item => item.id)).toContain(blockedId);
+ });
+
+ it('checks the Cover source analysis executor instead of the image executor', async () => {
+ root = await mkdtemp(join(tmpdir(), 'creator-preflight-'));
+ const stage = createCoverTemplate().stages.find(candidate => candidate.id === 'analyze-source')!;
+ const result = await createCreatorPreflight({
+ configStore: { read: async () => createDefaultCreatorServicesConfig() },
+ readCapabilities: () => createKrillinCreatorServicesCapabilities('win32', 'x64'),
+ resourceRoot: join(root, 'runtime'),
+ jobsRoot: join(root, 'jobs'),
+ executorIds: ['cover-analysis']
+ }).check(fakeJob('cover', { sourceType: 'youtube', sourceUrl: 'https://youtu.be/example' }), stage);
+
+ expect(result.blocked.map(item => item.id)).toEqual(expect.arrayContaining(['llm', 'yt-dlp']));
+ });
+
+ it('validates Volcengine TTS with App ID and Access Token credentials', async () => {
+ root = await mkdtemp(join(tmpdir(), 'creator-preflight-'));
+ const config = createDefaultCreatorServicesConfig();
+ config.tts.provider = 'volcengine';
+ const stage = createSmartDubbingTemplate().stages.find(candidate => candidate.id === 'tts')!;
+ const preflight = createCreatorPreflight({
+ configStore: { read: async () => config },
+ readCapabilities: () => createKrillinCreatorServicesCapabilities('win32', 'x64'),
+ resourceRoot: join(root, 'runtime'),
+ jobsRoot: join(root, 'jobs'),
+ executorIds: ['smart-dubbing'],
+ validateRuntimeAssets: false
+ });
+
+ const blocked = await preflight.check(fakeJob('smart-dubbing', { ttsProvider: 'volcengine' }), stage);
+ expect(blocked.blocked.map(item => item.id)).toContain('tts');
+
+ config.tts.volcengine.appId = 'app-id';
+ config.tts.volcengine.accessToken = 'access-token';
+ const ready = await preflight.check(fakeJob('smart-dubbing', { ttsProvider: 'volcengine' }), stage);
+ expect(ready.blocked.map(item => item.id)).not.toContain('tts');
+ });
+
+ it('blocks Volcengine transcription when its shared credentials are missing', async () => {
+ root = await mkdtemp(join(tmpdir(), 'creator-preflight-'));
+ const config = createDefaultCreatorServicesConfig();
+ config.transcription.provider = 'volcengine';
+ const stage = createVideoTranslationTemplate().stages.find(candidate => candidate.id === 'subtitle')!;
+ const result = await createCreatorPreflight({
+ configStore: { read: async () => config },
+ readCapabilities: () => createKrillinCreatorServicesCapabilities('win32', 'x64'),
+ resourceRoot: join(root, 'runtime'),
+ jobsRoot: join(root, 'jobs'),
+ executorIds: ['krillinai'],
+ validateRuntimeAssets: false
+ }).check(fakeJob('video-translation', {
+ sourceType: 'file',
+ sourceArtifactId: 'missing-source'
+ }), stage);
+
+ expect(result.blocked.map(item => item.id)).toContain('transcription-config');
+ });
+
++ it('accepts the Codex runtime for Krillin subtitle translation without a creator API key', async () => {
++ root = await mkdtemp(join(tmpdir(), 'creator-preflight-'));
++ const config = createDefaultCreatorServicesConfig();
++ config.llm.source = 'codex';
++ config.llm.apiKey = '';
++ config.llm.model = 'gpt-5.6-sol';
++ const stage = createVideoTranslationTemplate().stages.find(candidate => candidate.id === 'subtitle')!;
++ const result = await createCreatorPreflight({
++ configStore: { read: async () => config },
++ readCapabilities: () => createKrillinCreatorServicesCapabilities('darwin', 'arm64'),
++ resourceRoot: join(root, 'runtime'),
++ jobsRoot: join(root, 'jobs'),
++ executorIds: ['krillinai'],
++ validateRuntimeAssets: false
++ }).check(fakeJob('video-translation', {
++ sourceType: 'url',
++ sourceUrl: 'https://youtu.be/example'
++ }), stage);
++
++ expect(result.blocked.map(item => item.id)).not.toContain('llm');
++ expect(result.ready).toEqual(expect.arrayContaining([
++ expect.objectContaining({ id: 'llm', executionMode: 'local' })
++ ]));
++ });
++
+ it('resolves historical stale inputs the same way as StageRunner', async () => {
+ root = await mkdtemp(join(tmpdir(), 'creator-preflight-'));
+ const referencePath = join(root, 'reference.png');
+ await writeFile(referencePath, 'image');
+ const config = createDefaultCreatorServicesConfig();
+ config.image.openai.apiKey = 'test-key';
+ config.image.openai.baseUrl = 'https://example.test/v1';
+ config.image.openai.model = 'image-model';
+ const job = fakeJob('image-generation', {
+ provider: 'openai',
+ prompt: 'test',
+ referenceImageArtifactId: 'reference-image',
+ resultSnapshots: [{
+ version: 1,
+ createdAt: new Date(0).toISOString(),
+ action: 'generate',
+ stageId: 'generate',
+ description: 'historical',
+ artifactRefs: { reference_image: ['reference-image'] },
+ changedArtifactIds: ['reference-image'],
+ staleArtifactIds: [],
+ state: { referenceImageArtifactId: 'reference-image', provider: 'openai' }
+ }]
+ });
+ job.artifacts.push({
+ id: 'reference-image',
+ jobId: job.id,
+ kind: 'reference_image',
+ status: 'stale',
+ version: 1,
+ path: referencePath,
+ scopeKey: null,
+ inputFingerprint: null,
+ sha256: null,
+ sourceArtifactIds: [],
+ metadata: {},
+ createdAt: new Date(0).toISOString()
+ });
+
+ const result = await createCreatorPreflight({
+ configStore: { read: async () => config },
+ readCapabilities: () => createKrillinCreatorServicesCapabilities('win32', 'x64'),
+ resourceRoot: join(root, 'runtime'),
+ jobsRoot: join(root, 'jobs'),
+ executorIds: ['image']
+ }).check(job, createImageGenerationTemplate().stages[0]!, { inputResultVersion: 1 });
+
+ expect(result.blocked.map(item => item.id)).not.toContain('input-artifact:reference_image');
+ expect(result.ready.map(item => item.id)).toContain('input-file:reference-image');
+ });
+});
+
+function fakeJob(templateId: string, state: Record<string, CreatorJson>): CreatorJob {
+ return {
+ id: 'job-preflight',
+ projectId: 'project-preflight',
+ templateId,
+ templateVersion: templateId === 'image-generation' ? 2 : 2,
+ status: 'draft',
+ revision: 0,
+ state,
+ agentThreadId: null,
+ stages: [],
+ artifacts: [],
+ providerRequests: [],
+ activities: [],
+ createdAt: new Date(0).toISOString(),
+ updatedAt: new Date(0).toISOString()
+ };
+}
diff --cc apps/daemon/test/unit/creator-preset-schemas.test.ts
index fee7f33b,fee7f33b..7dbad178
--- a/apps/daemon/test/unit/creator-preset-schemas.test.ts
+++ b/apps/daemon/test/unit/creator-preset-schemas.test.ts
@@@ -161,14 -161,14 +161,13 @@@ describe('creator preset module schemas
locale: 'zh-CN',
requirement: {
service: 'tts',
-- provider: 'minimax',
-- model: 'required-tts-model'
++ capabilities: ['speech-generation']
},
services
});
expect(required).toMatchObject({
-- ttsProvider: 'minimax',
-- ttsModel: 'required-tts-model'
++ ttsProvider: 'aliyun',
++ ttsModel: 'configured-tts-model'
});
});
@@@ -228,7 -228,7 +227,7 @@@
});
});
-- it('binds every public module and validates provider requirements', () => {
++ it('binds every public module and validates capability requirements', () => {
expect(creatorPresetModuleDefinitions.map(definition => ({
module: definition.module,
runtime: `${definition.runtimeTemplate.id}@${definition.runtimeTemplate.version}`
@@@ -244,20 -244,20 +243,44 @@@
expect(() => getCreatorPresetModuleDefinition('video-generation')
.validateRequirement({
service: 'video',
-- provider: 'seedance',
-- model: videoGenerationModelIds.seedance[0]
++ capabilities: ['text-to-video']
})).not.toThrow();
expect(() => getCreatorPresetModuleDefinition('video-generation')
.validateRequirement({
service: 'video',
-- provider: 'seedance',
-- model: 'unavailable-model'
-- })).toThrow('unsupported video provider or model');
++ capabilities: ['text-to-image']
++ })).toThrow('unsupported video capability');
expect(() => getCreatorPresetModuleDefinition('image-generation')
.validateRequirement({
service: 'image',
-- provider: 'openai',
-- model: 'gpt-image-1'
-- })).toThrow('cannot select a model');
++ capabilities: ['text-to-image']
++ })).not.toThrow();
++
++ expect(creatorPresetSourceManifestSchema.safeParse({
++ schemaVersion: 1,
++ id: 'invalid-provider-binding',
++ version: 1,
++ module: 'image-generation',
++ runtimeTemplate: { id: 'image-generation', version: 2 },
++ status: 'published',
++ title: { 'zh-CN': '测试', 'en-US': 'Test' },
++ description: { 'zh-CN': '测试', 'en-US': 'Test' },
++ cover: 'cover.jpg',
++ requirements: { service: 'image', capabilities: ['text-to-image'], provider: 'openai' },
++ defaults: {}
++ }).success).toBe(false);
++ expect(creatorPresetSourceManifestSchema.safeParse({
++ schemaVersion: 1,
++ id: 'invalid-model-binding',
++ version: 1,
++ module: 'image-generation',
++ runtimeTemplate: { id: 'image-generation', version: 2 },
++ status: 'published',
++ title: { 'zh-CN': '测试', 'en-US': 'Test' },
++ description: { 'zh-CN': '测试', 'en-US': 'Test' },
++ cover: 'cover.jpg',
++ requirements: { service: 'image', capabilities: ['text-to-image'], model: 'gpt-image-1' },
++ defaults: {}
++ }).success).toBe(false);
});
});
diff --cc apps/daemon/test/unit/creator-service.test.ts
index 2602ee5f,2602ee5f..aef893b7
--- a/apps/daemon/test/unit/creator-service.test.ts
+++ b/apps/daemon/test/unit/creator-service.test.ts
@@@ -170,7 -170,7 +170,7 @@@ describe('creator service', () =>
defaultsByLocale: {
'en-US': { prompt: 'English product image' }
},
-- requirements: { service: 'image', provider: 'openai' }
++ requirements: { service: 'image', capabilities: ['text-to-image'] }
})
], config);
@@@ -208,12 -208,12 +208,48 @@@
});
expect(job.activities[0]?.details).toMatchObject({
requirementService: 'image',
-- requirementProvider: 'openai'
++ requirementCapabilities: ['text-to-image']
});
expect(JSON.stringify(job)).not.toContain('apiKey');
db.close();
});
++ it('inherits the configured image provider for provider-agnostic image presets', async () => {
++ const config = createDefaultCreatorServicesConfig();
++ config.image.provider = 'codex-native';
++ const { db, service } = setupPresetService([
++ preset({
++ module: 'image-generation',
++ id: 'reference-image-preset',
++ runtimeTemplate: { id: 'image-generation', version: 2 },
++ defaults: {
++ prompt: 'Transform the uploaded portrait',
++ size: '1024x1536',
++ quality: 'high',
++ candidateCount: 1
++ }
++ })
++ ], config);
++
++ const job = await service.createJob({
++ projectId: 'project_preset',
++ preset: {
++ module: 'image-generation',
++ id: 'reference-image-preset',
++ version: 1
++ },
++ locale: 'zh-CN',
++ creationKey: 'preset-create-codex-default'
++ });
++
++ expect(job.state).toMatchObject({
++ provider: 'codex-native',
++ candidateCount: 1
++ });
++ expect(job.presetOrigin?.id).toBe('reference-image-preset');
++ db.close();
++ });
++
it('replays only an identical resolved preset creation fingerprint', async () => {
const config = createDefaultCreatorServicesConfig();
config.video.seedance.model = videoGenerationModelIds.seedance[0];
@@@ -262,6 -262,6 +298,8 @@@
it('keeps edited preset state and avoids the executor when requirements are missing', async () => {
const config = createDefaultCreatorServicesConfig();
++ config.image.provider = 'jimeng';
++ config.image.jimeng.apiKey = 'configured-jimeng-key';
const { db, repository, service, templates } = setupPresetService([
preset({
module: 'image-generation',
@@@ -273,7 -273,7 +311,7 @@@
quality: 'medium',
candidateCount: 2
},
-- requirements: { service: 'image', provider: 'openai' }
++ requirements: { service: 'image', capabilities: ['reference-image'] }
})
], config);
const created = await service.createJob({
@@@ -327,8 -327,8 +365,9 @@@
db.close();
});
-- it('blocks execution when a preset-required TTS model is changed', async () => {
++ it('does not let a preset pin the configured TTS model', async () => {
const config = createDefaultCreatorServicesConfig();
++ config.tts.provider = 'aliyun';
config.tts.aliyun.apiKey = 'configured-aliyun-key';
config.tts.aliyun.model = 'configured-default-model';
const { db, repository, service, templates } = setupPresetService([
@@@ -344,8 -344,8 +383,7 @@@
},
requirements: {
service: 'tts',
-- provider: 'aliyun',
-- model: 'required-tts-model'
++ capabilities: ['speech-generation']
}
})
], config);
@@@ -361,7 -361,7 +399,7 @@@
});
expect(created.state).toMatchObject({
ttsProvider: 'aliyun',
-- ttsModel: 'required-tts-model'
++ ttsModel: 'configured-default-model'
});
const edited = service.applyAction(created.id, {
@@@ -384,22 -384,22 +422,10 @@@
});
const stage = await runner.run(edited.id, 'tts');
-- const waiting = service.getJob(edited.id)!;
expect(stage).toMatchObject({
-- status: 'failed',
-- errorCode: 'creator_preset_requirement_missing'
++ status: 'succeeded'
});
-- expect(waiting).toMatchObject({
-- status: 'needs_input',
-- state: {
-- ttsModel: 'tampered-tts-model',
-- needsInput: {
-- code: 'creator_preset_requirement_missing',
-- deepLink: '#/settings?tab=ai-services&section=tts'
-- }
-- }
-- });
-- expect(run).not.toHaveBeenCalled();
++ expect(run).toHaveBeenCalledOnce();
await runner.close();
db.close();
});
diff --cc apps/daemon/test/unit/creator-services-config-store.test.ts
index 65a365c4,f1a8a0d9..015cbc16
--- a/apps/daemon/test/unit/creator-services-config-store.test.ts
+++ b/apps/daemon/test/unit/creator-services-config-store.test.ts
@@@ -75,9 -73,34 +75,36 @@@ describe('CreatorServicesConfigStore',
});
});
+ it('persists Codex native image selection without an image API credential', async () => {
+ let saved: string | null = null;
+ const store = createCreatorServicesConfigStore({
+ getPassword: vi.fn(async () => saved),
+ setPassword: vi.fn(async value => { saved = value; }),
+ deletePassword: vi.fn(async () => { saved = null; })
+ });
+ const config = createDefaultCreatorServicesConfig();
+ config.image.provider = 'codex-native';
+
+ await expect(store.write(config)).resolves.toEqual(config);
+ await expect(store.read()).resolves.toEqual(config);
+
+ const presented = presentCreatorServicesConfig(config);
+ expect(presented.config.image.provider).toBe('codex-native');
+ expect(presented.config.image.codexNative).toEqual({});
+ expect(presented.configuredCredentials).not.toEqual(
+ expect.arrayContaining([
+ 'image.openai.apiKey',
+ 'image.jimeng.apiKey',
+ 'image.kling.accessKey',
+ 'image.kling.secretKey',
+ 'image.gemini.apiKey'
+ ])
+ );
+ });
+
it('stores public settings in config.toml and credentials in credentials.json', async () => {
+ vi.stubEnv('VOLCENGINE_APP_ID', '');
+ vi.stubEnv('VOLCENGINE_ACCESS_TOKEN', '');
root = mkdtempSync(join(tmpdir(), 'opencreator-creator-services-'));
const configFile = join(root, 'config.toml');
const credentialsFile = join(root, 'credentials.json');
diff --cc apps/daemon/test/unit/creator-stickman-images.test.ts
index 81a98c2b,1967b322..747c65aa
--- a/apps/daemon/test/unit/creator-stickman-images.test.ts
+++ b/apps/daemon/test/unit/creator-stickman-images.test.ts
@@@ -283,7 -284,7 +284,11 @@@ describe('stickman scoped images', () =
templates,
workRoot: join(tempDir, 'jobs'),
executors: [createStickmanImageExecutor({
-- configStore: { read: async () => createDefaultCreatorServicesConfig() },
++ configStore: { read: async () => {
++ const config = createDefaultCreatorServicesConfig();
++ config.image.provider = 'openai';
++ return config;
++ } },
ledger: new CreatorProviderRequestLedger(repository),
async validateCandidate() {
candidateValidations += 1;
@@@ -464,6 -465,103 +469,102 @@@
db.close();
});
- it('uses the portrait canvas and materializes Codex-native reference paths for Shorts', async () => {
++ it('uses the portrait canvas and submits Codex-native reference bytes for Shorts', async () => {
+ const { db, repository, templates, service } = setup();
+ const job = service.createJob({
+ projectId: 'p1',
+ templateId: 'stickman-video',
+ state: {
+ ratio: '9:16',
+ characterAsset: { assetId: 'stickman.character.default', revision: 1 },
+ styleAsset: { assetId: 'stickman.style.minimal-ink', revision: 1 }
+ }
+ });
+ const shotSpecPath = join(tempDir, 'portrait-shot.json');
+ writeFileSync(shotSpecPath, JSON.stringify({
+ scriptArtifactId: 'script-1',
+ audioTimingArtifactId: 'audio-timing-1',
+ timingSource: 'ffprobe_cumulative_tts_duration',
+ shots: [shot('shot-01', 'segment-01', 'portrait scene', 'static', 0)]
+ }));
+ const shotSpecArtifact = repository.insertArtifact({
+ jobId: job.id,
+ kind: 'shot_spec',
+ status: 'completed',
+ path: shotSpecPath,
+ sha256: 'a'.repeat(64),
+ sourceArtifactIds: [],
+ metadata: {}
+ });
+ const reference = await sharp({
+ create: { width: 100, height: 100, channels: 4, background: '#333333' }
+ }).png().toBuffer();
+ const referencePath = join(tempDir, 'portrait-character.png');
+ writeFileSync(referencePath, reference);
+ const characterArtifact = repository.insertArtifact({
+ jobId: job.id,
+ kind: 'character_reference',
+ status: 'completed',
+ path: referencePath,
+ sha256: createHash('sha256').update(reference).digest('hex'),
+ sourceArtifactIds: [],
+ metadata: { assetId: 'stickman.character.default', revision: 1, mimeType: 'image/png' }
+ });
+ insertImageContracts({
+ repository,
+ jobId: job.id,
+ shotSpecId: shotSpecArtifact.id,
+ character: characterArtifact,
+ characterAssetId: 'stickman.character.default',
+ ratio: '9:16',
+ prompts: [{ shotId: 'shot-01', visualDescription: 'portrait scene', prompt: 'portrait scene' }]
+ });
+ const stage = repository.createStageRun({
+ jobId: job.id,
+ stageId: 'images',
+ executor: 'stickman-image',
+ status: 'queued',
+ scopeKey: 'shot-01',
+ inputFingerprint: '1'.repeat(64)
+ });
+ const generatedImage = await sharp({
+ create: { width: 300, height: 200, channels: 4, background: '#ffffff' }
+ }).png().toBuffer();
+ const config = createDefaultCreatorServicesConfig();
+ config.image.provider = 'codex-native';
+ let submittedSize = '';
- let submittedPaths: string[] = [];
++ let submittedReferences: Buffer[] = [];
+ const runner = createCreatorStageRunner({
+ repository,
+ templates,
+ workRoot: join(tempDir, 'jobs'),
+ executors: [createStickmanImageExecutor({
+ configStore: { read: async () => config },
+ ledger: new CreatorProviderRequestLedger(repository),
+ validateCandidate: acceptCandidate,
+ async generate(request, _config, options) {
+ submittedSize = request.size;
- submittedPaths = options?.codexNativeImagePaths ?? [];
++ submittedReferences = options?.referenceImages?.map(item => item.content) ?? [];
+ return {
+ model: 'codex-native',
+ contents: [{ mime: 'image/png' as const, content: generatedImage }]
+ };
+ }
+ })]
+ });
+
+ const completed = await runner.runStageRun(stage.id);
+
+ expect(completed.status).toBe('succeeded');
+ expect(submittedSize).toBe('1024x1536');
- expect(submittedPaths).toHaveLength(1);
- expect(submittedPaths[0]).not.toBe(referencePath);
- expect(readFileSync(submittedPaths[0]!)).toEqual(reference);
++ expect(submittedReferences).toHaveLength(1);
++ expect(submittedReferences[0]).toEqual(reference);
+ const generated = service.getJob(job.id)!.artifacts.find(artifact => artifact.kind === 'shot_image');
+ expect(await sharp(generated!.path!).metadata()).toMatchObject({ width: 720, height: 1280 });
+ await runner.close();
+ db.close();
+ });
+
it('keeps successful shot artifacts when another scope fails', async () => {
const { db, repository, templates, service } = setup();
const job = service.createJob({
diff --cc apps/daemon/test/unit/creator-video-translation-workflow.test.ts
index f2495c64,9aed99d0..13d5e668
--- a/apps/daemon/test/unit/creator-video-translation-workflow.test.ts
+++ b/apps/daemon/test/unit/creator-video-translation-workflow.test.ts
@@@ -20,24 -20,6 +20,56 @@@ afterEach(() =>
});
describe('video translation workflow', () => {
++ it('accepts Codex runtime translation without a creator API key', async () => {
++ const fixture = setup({});
++ const config = createDefaultCreatorServicesConfig();
++ config.llm.source = 'codex';
++ config.llm.apiKey = '';
++ const workflow = createVideoTranslationWorkflow({
++ creator: fixture.service,
++ dispatcher: fixture.dispatcher,
++ configStore: { read: vi.fn(async () => config) }
++ });
++
++ await expect(workflow.validateStage(fixture.service.getJob(fixture.jobId)!, 'subtitle'))
++ .resolves.toBeUndefined();
++ fixture.db.close();
++ });
++
++ it('still requires complete credentials for a custom translation model', async () => {
++ const fixture = setup({});
++ const config = createDefaultCreatorServicesConfig();
++ config.llm.source = 'custom';
++ config.llm.apiKey = '';
++ const workflow = createVideoTranslationWorkflow({
++ creator: fixture.service,
++ dispatcher: fixture.dispatcher,
++ configStore: { read: vi.fn(async () => config) }
++ });
++
++ await expect(workflow.validateStage(fixture.service.getJob(fixture.jobId)!, 'subtitle'))
++ .rejects.toMatchObject({ code: 'creator_llm_config_missing' });
++ fixture.db.close();
++ });
++
+ it.each([
+ 'https://www.youtube.com/watch?v=xVWS7yHdzCU',
+ 'https://youtu.be/tAkC-ZdaqWs?si=6LcL-jgzdBaZ1IFD'
+ ])('accepts the supported YouTube URL form: %s', async sourceUrl => {
+ const fixture = setup({ sourceUrl });
+ const config = createDefaultCreatorServicesConfig();
+ config.llm.apiKey = 'llm-key';
+ const workflow = createVideoTranslationWorkflow({
+ creator: fixture.service,
+ dispatcher: fixture.dispatcher,
+ configStore: { read: vi.fn(async () => config) }
+ });
+
+ await expect(workflow.validateStage(fixture.service.getJob(fixture.jobId)!, 'subtitle'))
+ .resolves.toBeUndefined();
+ fixture.db.close();
+ });
+
it('queues the selected stages in order through the command dispatcher', async () => {
const fixture = setup({ dubbing: true, composeVideo: true, videoFormat: 'all' });
const config = createDefaultCreatorServicesConfig();
diff --cc apps/daemon/test/unit/image-generation-codex-native.test.ts
index 00000000,d8b0ab29..44448c10
mode 000000,100644..100644
--- a/apps/daemon/test/unit/image-generation-codex-native.test.ts
+++ b/apps/daemon/test/unit/image-generation-codex-native.test.ts
@@@ -1,0 -1,138 +1,138 @@@
-import { mkdir, mkdtemp, rm, writeFile } from 'node:fs/promises';
++import { mkdtemp, rm } from 'node:fs/promises';
+ import { tmpdir } from 'node:os';
+ import { join } from 'node:path';
+ import { afterEach, describe, expect, it, vi } from 'vitest';
+ import { createDefaultCreatorServicesConfig } from '@opencreator/protocol';
-import type {
- CodexAppServerHost,
- CodexAppServerResult,
- CodexAppServerTurnInput
-} from '../../src/codex/app-server-host-2026-07-28.js';
+ import { generateImageContents } from '../../src/image-generation/provider.js';
+
+ const png = Buffer.from([
+ 0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a,
+ 0x00, 0x00, 0x00, 0x00
+ ]);
+
+ describe('codex-native provider dispatch', () => {
+ let root = '';
+
+ afterEach(async () => {
+ if (root) await rm(root, { recursive: true, force: true });
+ root = '';
+ });
+
- it('uses the local Codex host and never calls the remote image fetcher', async () => {
++ it('uses the local Codex provider with no image-service configuration', async () => {
+ root = await mkdtemp(join(tmpdir(), 'opencreator-native-dispatch-'));
- const codexHome = join(root, 'codex-home');
- const savedPath = join(codexHome, 'generated_images', 'result.png');
- await mkdir(join(codexHome, 'generated_images'), { recursive: true });
- await writeFile(savedPath, png);
- const createHost = fakeHost(savedPath);
- const fetchImpl = vi.fn() as typeof fetch;
++ const fetchImpl = vi.fn(async () => new Response(JSON.stringify({
++ data: [{ b64_json: png.toString('base64') }]
++ }), { status: 200 })) as typeof fetch;
+ const config = createDefaultCreatorServicesConfig();
+ config.image.provider = 'codex-native';
+
+ const result = await generateImageContents({
+ prompt: 'an original orange cat',
+ provider: 'codex-native',
+ size: '1024x1024',
+ quality: 'medium',
+ count: 1
+ }, config, {
+ fetchImpl,
+ codexNative: {
- codexBin: 'codex',
- codexHome,
- cwd: root,
- createHost
++ codexHome: join(root, 'codex-home'),
++ readProvider: async () => ({
++ baseUrl: 'https://forward.example.test/v1',
++ apiKey: 'local-codex-secret',
++ model: 'gpt-image-1'
++ })
+ }
+ });
+
- expect(result).toMatchObject({ model: 'codex-native' });
++ expect(result).toMatchObject({ model: 'gpt-image-1' });
+ expect(result.contents[0]).toMatchObject({ content: png, mime: 'image/png' });
- expect(fetchImpl).not.toHaveBeenCalled();
- expect(createHost).toHaveBeenCalledTimes(1);
++ expect(fetchImpl).toHaveBeenCalledWith(
++ new URL('https://forward.example.test/v1/images/generations'),
++ expect.objectContaining({
++ headers: expect.objectContaining({ Authorization: 'Bearer local-codex-secret' })
++ })
++ );
+ });
+
- it('rejects native requests for more than one image without starting a host', async () => {
++ it('rejects native requests for more than one image before reading the provider', async () => {
+ const config = createDefaultCreatorServicesConfig();
- const createHost = vi.fn();
++ const readProvider = vi.fn();
+ config.image.provider = 'codex-native';
+
+ await expect(generateImageContents({
+ prompt: 'cat',
+ provider: 'codex-native',
+ size: '1024x1024',
+ quality: 'low',
+ count: 2
+ }, config, {
+ codexNative: {
- codexBin: 'codex',
+ codexHome: 'C:\\codex-home',
- cwd: 'C:\\workspace',
- createHost
++ readProvider
+ }
+ })).rejects.toMatchObject({
+ code: 'unsupported_capability',
+ message: expect.stringContaining('one image')
+ });
- expect(createHost).not.toHaveBeenCalled();
++ expect(readProvider).not.toHaveBeenCalled();
++ });
++
++ it('sends Codex reference images through the provider edit endpoint', async () => {
++ const config = createDefaultCreatorServicesConfig();
++ const fetchMock = vi.fn(async (_input: RequestInfo | URL, _init?: RequestInit) => (
++ new Response(JSON.stringify({ data: [{ b64_json: png.toString('base64') }] }), { status: 200 })
++ ));
++ const first = Buffer.concat([png, Buffer.from('first-reference')]);
++ const second = Buffer.concat([png, Buffer.from('second-reference')]);
++
++ await generateImageContents({
++ prompt: 'keep the same character',
++ provider: 'codex-native',
++ size: '1024x1024',
++ quality: 'medium',
++ count: 1
++ }, config, {
++ fetchImpl: fetchMock as typeof fetch,
++ referenceImages: [
++ { content: first, mime: 'image/png' },
++ { content: second, mime: 'image/png' }
++ ],
++ codexNative: {
++ codexHome: '/codex-home',
++ readProvider: async () => ({
++ baseUrl: 'https://forward.example.test/v1',
++ apiKey: 'local-codex-secret',
++ model: 'gpt-image-1'
++ })
++ }
++ });
++
++ expect(String(fetchMock.mock.calls[0]?.[0]))
++ .toBe('https://forward.example.test/v1/images/edits');
++ const request = fetchMock.mock.calls[0]?.[1];
++ expect(request?.headers).toMatchObject({
++ Authorization: 'Bearer local-codex-secret',
++ 'Content-Type': expect.stringContaining('multipart/form-data; boundary=')
++ });
++ const body = Buffer.from(request?.body as ArrayBuffer).toString('latin1');
++ expect(body.match(/name="image\[\]"/g)).toHaveLength(2);
++ expect(body.indexOf('first-reference')).toBeLessThan(body.indexOf('second-reference'));
+ });
+
+ it('reports missing native runtime settings as configuration error without API fallback', async () => {
+ const config = createDefaultCreatorServicesConfig();
+ config.image.provider = 'codex-native';
+ const fetchImpl = vi.fn() as typeof fetch;
+
+ await expect(generateImageContents({
+ prompt: 'cat',
+ provider: 'codex-native',
+ size: '1024x1024',
+ quality: 'low',
+ count: 1
+ }, config, { fetchImpl })).rejects.toMatchObject({
+ code: 'config_missing'
+ });
+ expect(fetchImpl).not.toHaveBeenCalled();
+ });
+ });
-
-function fakeHost(savedPath: string) {
- return vi.fn((): CodexAppServerHost => ({
- pid: 123,
- started: Promise.resolve(123),
- run: vi.fn((input: CodexAppServerTurnInput) => ({
- cancel: vi.fn(),
- result: (async () => {
- await input.onNotification?.({
- method: 'item/completed',
- params: {
- item: {
- type: 'imageGeneration',
- status: 'completed',
- failure: null,
- savedPath
- }
- }
- });
- return completedResult;
- })()
- })),
- isReusable: vi.fn(() => false),
- close: vi.fn(async () => undefined)
- }));
-}
-
-const completedResult: CodexAppServerResult = {
- threadId: 'thread-1',
- turnId: 'turn-1',
- turnStatus: 'completed',
- stderr: '',
- terminationReason: 'completed',
- outputTruncation: {
- stderr: { truncated: false, droppedBytes: 0, droppedItems: 0 },
- frames: { truncated: false, droppedBytes: 0, droppedItems: 0 }
- }
-};
diff --cc apps/daemon/test/unit/krillin-codex-llm-gateway.test.ts
index 00000000,00000000..20908854
new file mode 100644
--- /dev/null
+++ b/apps/daemon/test/unit/krillin-codex-llm-gateway.test.ts
@@@ -1,0 -1,0 +1,98 @@@
++import Fastify from 'fastify';
++import { describe, expect, it, vi } from 'vitest';
++import { createKrillinCodexLlmGateway } from '../../src/creator/krillin/codex-llm-gateway.js';
++
++describe('Krillin Codex LLM gateway', () => {
++ it('authenticates and converts a Codex final message to chat completions', async () => {
++ const run = vi.fn((input: { onNotification?(value: Record<string, unknown>): void }) => {
++ input.onNotification?.({
++ method: 'item/completed',
++ params: { item: { id: 'answer', type: 'agentMessage', text: '{"translation":"你好"}' } }
++ });
++ return {
++ cancel() {},
++ result: Promise.resolve({
++ threadId: 'thread-1',
++ turnId: 'turn-1',
++ turnStatus: 'completed' as const,
++ stderr: '',
++ terminationReason: 'completed' as const,
++ outputTruncation: {
++ stderr: { truncated: false, droppedBytes: 0, droppedItems: 0 },
++ frames: { truncated: false, droppedBytes: 0, droppedItems: 0 }
++ }
++ })
++ };
++ });
++ const createHost = vi.fn(() => ({
++ pid: 1,
++ started: Promise.resolve(1),
++ run,
++ isReusable: () => true,
++ close: vi.fn(async () => undefined)
++ }));
++ const gateway = createKrillinCodexLlmGateway({
++ codexBin: '/bundled/codex',
++ codexHome: '/isolated/codex-home',
++ cwd: '/workspace',
++ createHost
++ });
++ const server = Fastify();
++ await gateway.register(server);
++ const config = gateway.config('http://127.0.0.1:1234');
++
++ const unauthorized = await server.inject({
++ method: 'POST',
++ url: '/internal/krillin-llm/v1/chat/completions',
++ payload: { messages: [{ role: 'user', content: 'translate' }] }
++ });
++ expect(unauthorized.statusCode).toBe(401);
++
++ const response = await server.inject({
++ method: 'POST',
++ url: '/internal/krillin-llm/v1/chat/completions',
++ headers: { authorization: `Bearer ${config.apiKey}` },
++ payload: {
++ model: 'codex',
++ messages: [
++ { role: 'system', content: 'Translate subtitles.' },
++ { role: 'user', content: 'Hello' }
++ ],
++ response_format: { type: 'json_object' }
++ }
++ });
++
++ expect(response.statusCode).toBe(200);
++ expect(response.json()).toMatchObject({
++ model: 'codex',
++ choices: [{ message: { role: 'assistant', content: '{"translation":"你好"}' } }]
++ });
++ expect(run).toHaveBeenCalledWith(expect.objectContaining({
++ prompt: expect.stringContaining('SYSTEM:\nTranslate subtitles.'),
++ developerInstructions: expect.stringContaining('valid JSON')
++ }));
++ const origin = await server.listen({ port: 0, host: '127.0.0.1' });
++ const streamed = await fetch(`${origin}/internal/krillin-llm/v1/chat/completions`, {
++ method: 'POST',
++ headers: {
++ authorization: `Bearer ${config.apiKey}`,
++ 'content-type': 'application/json'
++ },
++ body: JSON.stringify({
++ model: 'codex',
++ stream: true,
++ messages: [{ role: 'user', content: 'Hello' }]
++ })
++ });
++ const streamBody = await streamed.text();
++ expect(streamed.status).toBe(200);
++ expect(streamed.headers.get('content-type')).toContain('text/event-stream');
++ expect(streamBody).toContain('"object":"chat.completion.chunk"');
++ expect(streamBody).toContain('"content":"{\\"translation\\":\\"你好\\"}"');
++ expect(streamBody).toContain('data: [DONE]');
++ expect(createHost).toHaveBeenCalledTimes(1);
++ expect(run).toHaveBeenCalledTimes(2);
++ await gateway.close();
++ await server.close();
++ });
++});
diff --cc apps/daemon/test/unit/real-person-sticker-presets.test.ts
index d9f1245b,d9f1245b..8ac89d81
--- a/apps/daemon/test/unit/real-person-sticker-presets.test.ts
+++ b/apps/daemon/test/unit/real-person-sticker-presets.test.ts
@@@ -107,7 -107,7 +107,7 @@@ describe('real-person sticker tutorial
expect(en.find(preset => preset.id === image?.id)?.prompt).toContain('photorealistic');
expect(en.find(preset => preset.id === video?.id)?.prompt).toContain('freeze');
const imageSource = registry.get({ ...presets[0], version: 1 });
-- expect(imageSource.requirements).toEqual({ service: 'image', provider: 'openai' });
++ expect(imageSource.requirements).toBeUndefined();
expect(imageSource.defaults).toMatchObject({
size: '1024x1536', quality: 'high', candidateCount: 1
});
diff --cc apps/daemon/test/unit/retro-illustration-presets.test.ts
index 5abbeabf,5abbeabf..27f7d40b
--- a/apps/daemon/test/unit/retro-illustration-presets.test.ts
+++ b/apps/daemon/test/unit/retro-illustration-presets.test.ts
@@@ -119,7 -119,7 +119,7 @@@ describe('retro illustration tutorial p
const imageSource = registry.get({
module: 'image-generation', id: 'retro-halftone-illustration', version: 1
});
-- expect(imageSource.requirements).toEqual({ service: 'image', provider: 'openai' });
++ expect(imageSource.requirements).toBeUndefined();
expect(imageSource.defaults.candidateCount).toBe(1);
const videoSource = registry.get({
module: 'video-generation', id: 'retro-illustration-micro-motion', version: 1
diff --cc apps/web/src/features/conversation/CreatorDashboard.tsx
index 37623227,37623227..beb2e60c
--- a/apps/web/src/features/conversation/CreatorDashboard.tsx
+++ b/apps/web/src/features/conversation/CreatorDashboard.tsx
@@@ -344,10 -344,10 +344,7 @@@ export function CreatorDashboard(props
{selectedPreset.requirements !== null ? (
<p className="creator-template-runtime-requirement">
{language === 'en-US' ? 'Requires' : '运行需要'}: {' '}
-- {selectedPreset.requirements.provider}
-- {selectedPreset.requirements.model === undefined
-- ? ''
-- : ` / ${selectedPreset.requirements.model}`}
++ {selectedPreset.requirements.capabilities.join(', ')}
</p>
) : null}
diff --cc apps/web/src/features/dashboard/DashboardPage.tsx
index c51234bd,5f309d82..af62677b
--- a/apps/web/src/features/dashboard/DashboardPage.tsx
+++ b/apps/web/src/features/dashboard/DashboardPage.tsx
@@@ -387,6 -382,6 +387,7 @@@ export default function DashboardPage(p
return renderCreatorWorkspace('image-generation', (
<ImageGenerationWorkspace
promptHint={activePromptHint}
++ creatorServicesService={props.creatorServicesService}
onBack={closeWorkspace}
/>
));
diff --cc apps/web/src/features/dashboard/ImageGenerationWorkspace.test.tsx
index f4ecbf65,f4ecbf65..fa496e98
--- a/apps/web/src/features/dashboard/ImageGenerationWorkspace.test.tsx
+++ b/apps/web/src/features/dashboard/ImageGenerationWorkspace.test.tsx
@@@ -5,6 -5,6 +5,7 @@@ import type
CreatorJob,
CreatorJson
} from '@opencreator/protocol';
++import { createDefaultCreatorServicesConfig } from '@opencreator/protocol';
import { beforeEach, describe, expect, it, vi } from 'vitest';
import { LanguageProvider } from '../../i18n/LanguageProvider.js';
import ImageGenerationWorkspace from './ImageGenerationWorkspace.js';
@@@ -50,6 -50,6 +51,26 @@@ describe('ImageGenerationWorkspace', (
}
});
++ it('inherits Codex and its single-candidate limit from AI service settings', async () => {
++ const fixture = createFixture({ pending: true });
++ const config = createDefaultCreatorServicesConfig();
++ config.image.provider = 'codex-native';
++ renderWorkspace(fixture, fixture.currentJob(), {
++ getConfig: vi.fn(async () => ({ config, configuredCredentials: [] }))
++ });
++
++ fireEvent.change(screen.getByRole('textbox', { name: '提示词' }), {
++ target: { value: '使用默认 Codex 生成一张图片' }
++ });
++ fireEvent.click(screen.getByRole('button', { name: '继续' }));
++ expect(await screen.findByRole('radio', { name: '本机 Codex 生图' })).toHaveAttribute(
++ 'aria-checked',
++ 'true'
++ );
++ expect(screen.getByRole('radio', { name: '1 张' })).toHaveAttribute('aria-checked', 'true');
++ expect(fixture.ensureJob).not.toHaveBeenCalled();
++ });
++
it.each([
['gemini', 'Gemini'],
['jimeng', '即梦'],
@@@ -176,7 -176,7 +197,8 @@@
function renderWorkspace(
fixture: ReturnType<typeof createFixture>,
-- initialJob = fixture.currentJob()
++ initialJob = fixture.currentJob(),
++ creatorServicesService?: { getConfig(): Promise<unknown> }
) {
return render(
<LanguageProvider initialPreference="zh-CN">
@@@ -190,7 -190,7 +212,10 @@@
runAgentTurn: vi.fn()
} as never}
>
-- <ImageGenerationWorkspace onBack={vi.fn()} />
++ <ImageGenerationWorkspace
++ onBack={vi.fn()}
++ creatorServicesService={creatorServicesService as never}
++ />
</CreatorSessionProvider>
</LanguageProvider>
);
diff --cc apps/web/src/features/dashboard/ImageGenerationWorkspace.tsx
index b1bdb09d,e1445f8e..7f465014
--- a/apps/web/src/features/dashboard/ImageGenerationWorkspace.tsx
+++ b/apps/web/src/features/dashboard/ImageGenerationWorkspace.tsx
@@@ -25,7 -25,7 +25,11 @@@ import { useLocalizedCopy } from '../..
import CreatorResultVersionMenu from './CreatorResultVersionMenu.js';
import CreatorTaskSummary from './CreatorTaskSummary.js';
import CreatorToolShell from './CreatorToolShell.js';
--import { useOptionalCreatorSession } from './creator-session-store.js';
++import type { CreatorServicesSettingsService } from '../../services/creator-services-service.js';
++import {
++ CreatorPreflightBlockedError,
++ useOptionalCreatorSession
++} from './creator-session-store.js';
type ImageStep = 0 | 1 | 2;
type ImageResultVersion = {
@@@ -48,6 -48,6 +52,7 @@@ const qualities: Array<{ value: ImageGe
];
const providers: Array<{ value: ImageGenerationProvider; zh: string; en: string }> = [
++ { value: 'codex-native', zh: '本机 Codex 生图', en: 'Local Codex image generation' },
{ value: 'openai', zh: 'GPT Image', en: 'GPT Image' },
{ value: 'jimeng', zh: '即梦', en: 'Jimeng' },
{ value: 'kling', zh: '可灵', en: 'Kling' },
@@@ -60,6 -61,6 +65,7 @@@ const samplePromptEn = 'A bright moder
export default function ImageGenerationWorkspace(props: {
onBack(): void;
promptHint?: string;
++ creatorServicesService?: CreatorServicesSettingsService | null;
}) {
const l = useLocalizedCopy();
const session = useOptionalCreatorSession();
@@@ -123,6 -124,6 +129,37 @@@
);
const currentReferenceName = referenceFile?.name
?? readArtifactString(activeReferenceArtifact, 'fileName');
++ const shouldLoadDefaultProvider = session !== null
++ && (
++ session.state.provider === undefined
++ || (
++ session.state.providerSource === undefined
++ && session.job.presetOrigin === null
++ && session.job.stages.length === 0
++ && session.job.artifacts.length === 0
++ )
++ );
++
++ useEffect(() => {
++ if (session === null || !shouldLoadDefaultProvider) return;
++ let active = true;
++ void props.creatorServicesService?.getConfig().then(response => {
++ if (!active) return;
++ const nextProvider = response.config.image.provider;
++ const nextCount = nextProvider === 'codex-native' ? 1 : count;
++ setProvider(nextProvider);
++ setCount(nextCount);
++ session.updateDraft(
++ {
++ provider: nextProvider,
++ providerSource: 'default',
++ candidateCount: nextCount
++ },
++ { persist: false }
++ );
++ }).catch(() => undefined);
++ return () => { active = false; };
++ }, [count, props.creatorServicesService, session, shouldLoadDefaultProvider]);
useEffect(() => {
if (referenceFile === null) {
@@@ -217,7 -218,9 +254,13 @@@
function updateProvider(value: ImageGenerationProvider) {
setProvider(value);
- session?.updateDraft({ provider: value });
+ const nextCount = value === 'codex-native' ? 1 : count;
+ if (nextCount !== count) setCount(nextCount);
- session?.updateDraft({ provider: value, candidateCount: nextCount });
++ session?.updateDraft({
++ provider: value,
++ providerSource: 'user',
++ candidateCount: nextCount
++ });
setError('');
}
@@@ -487,6 -491,14 +531,14 @@@
</button>
))}
</div>
+ {provider === 'codex-native' ? (
+ <p className="creator-services-inline-note">
+ {l(
- 'Codex 订阅模式使用本机已登录的 Codex 生成图像,不调用付费图像 API;每次任务生成 1 张。',
- 'Codex subscription mode uses the signed-in local Codex session, never a paid image API, and generates one image per task.'
++ '使用本机 Codex 生成图像,无需额外配置;每次任务生成 1 张。',
++ 'Use local Codex to generate images with no additional configuration; each task generates 1 image.'
+ )}
+ </p>
+ ) : null}
</div>
<div className="media-generation-control">
<span>{l('画幅', 'Format')}</span>
@@@ -755,6 -767,6 +807,10 @@@ function formatBytes(size: number)
}
function formatImageError(error: unknown, l: (zh: string, en: string) => string) {
++ if (error instanceof CreatorPreflightBlockedError) {
++ const message = error.result.blocked.map(item => item.message).filter(Boolean).join(';');
++ return message || l('启动前检查未通过,请检查任务配置', 'Preflight checks failed. Review the task settings.');
++ }
const candidate = error as { code?: unknown; message?: unknown };
const code = typeof candidate?.code === 'string' ? candidate.code : '';
if (code === 'creator_image_config_missing') {
diff --cc apps/web/src/features/dashboard/StickmanVideoWorkspace.tsx
index 8a09bd77,90f1a71f..01182567
--- a/apps/web/src/features/dashboard/StickmanVideoWorkspace.tsx
+++ b/apps/web/src/features/dashboard/StickmanVideoWorkspace.tsx
@@@ -279,10 -290,16 +292,12 @@@ export default function StickmanVideoWo
const providerConfig = provider === 'edge-tts'
? null
: response.config.tts[provider];
- const configured = provider === 'edge-tts'
- || (providerConfig !== null && (
- providerConfig.apiKey.trim().length > 0
- || response.configuredCredentials.some(credential => credential === `tts.${provider}.apiKey`)
- ));
+ const configured = ttsCredentialsConfigured(provider, response);
setTtsConfigurationStatus(configured ? 'configured' : 'missing');
const imageProvider = response.config.image.provider;
- if (imageProvider !== 'openai' && imageProvider !== 'gemini') {
+ if (imageProvider === 'codex-native') {
+ setImageConfigurationStatus('configured');
+ } else if (imageProvider !== 'openai' && imageProvider !== 'gemini') {
setImageConfigurationStatus('unsupported');
} else {
const credential = imageProvider === 'openai'
@@@ -415,7 -432,7 +430,7 @@@
}
if (imageConfigurationStatus !== 'configured') {
setNotice(imageConfigurationStatus === 'unsupported'
- ? l('当前生图服务不支持角色参考图,请在 AI 服务中切换到 OpenAI 或 Gemini', 'The current image provider does not support character references. Switch to OpenAI or Gemini in AI Services.')
- ? l('当前生图服务不支持角色参考图,请切换到 Codex(订阅)、OpenAI 或 Gemini', 'The current image provider does not support character references. Switch to Codex (subscription), OpenAI, or Gemini in AI Services.')
++ ? l('当前生图服务不支持角色参考图,请切换到本机 Codex 生图、OpenAI 或 Gemini', 'The current image provider does not support character references. Switch to local Codex image generation, OpenAI, or Gemini in AI Services.')
: imageConfigurationStatus === 'unavailable'
? l('暂时无法读取生图服务配置,请检查 Runtime 后重试', 'Could not read image settings. Check the Runtime and retry.')
: l('请先前往 AI 服务配置生图服务', 'Configure an image provider in AI Services first.'));
@@@ -1010,7 -1062,7 +1060,7 @@@ function SourceAndCharacterStep(props:
? props.l('当前生图服务不支持角色参考图', 'The image provider does not support character references')
: props.l('尚未配置生图服务', 'Image service is not configured')}</strong>
<small>{props.imageConfigurationStatus === 'unsupported'
- ? props.l('火柴人必须把所选角色图片随每个镜头提交,请切换到 OpenAI 或 Gemini。', 'Stickman generation must attach the selected character to every shot. Switch to OpenAI or Gemini.')
- ? props.l('火柴人必须把所选角色图片随每个镜头提交,请切换到 Codex(订阅)、OpenAI 或 Gemini。', 'Stickman generation must attach the selected character to every shot. Switch to Codex (subscription), OpenAI, or Gemini.')
++ ? props.l('火柴人必须把所选角色图片随每个镜头提交,请切换到本机 Codex 生图、OpenAI 或 Gemini。', 'Stickman generation must attach the selected character to every shot. Switch to local Codex image generation, OpenAI, or Gemini.')
: props.l('配置支持参考图的服务后,才能保证镜头使用所选角色。', 'Configure a reference-capable provider so every shot uses the selected character.')}</small>
</div>
{props.imageConfigurationStatus !== 'loading' ? (
diff --cc apps/web/src/features/settings/CreatorServicesSettingsView.test.tsx
index dde09932,209895ec..35e6bb6e
--- a/apps/web/src/features/settings/CreatorServicesSettingsView.test.tsx
+++ b/apps/web/src/features/settings/CreatorServicesSettingsView.test.tsx
@@@ -14,7 -14,7 +14,48 @@@ import type { CreatorServicesSettingsSe
import { CreatorServicesSettingsView } from './CreatorServicesSettingsView.js';
describe('CreatorServicesSettingsView', () => {
-- it('edits the shared model provider used by Agent and text tasks', async () => {
++ it('uses the local Codex runtime without exposing custom provider fields', async () => {
++ const user = userEvent.setup();
++ const service = createService([], runtimeCapabilities('darwin', 'arm64'), 'codex');
++ const modelService = createModelService({ authentication: 'chatgpt', apiKeyConfigured: false });
++ render(
++ <CreatorServicesSettingsView connected service={service} modelService={modelService} />
++ );
++
++ expect(await screen.findByRole('button', { name: 'Codex 本机运行时' }))
++ .toHaveAttribute('aria-pressed', 'true');
++ expect(screen.getByText('已连接本机 Codex · ChatGPT 登录')).toBeInTheDocument();
++ expect(screen.getByText('文本任务可用')).toBeInTheDocument();
++ expect(screen.queryByLabelText('Base URL')).not.toBeInTheDocument();
++ expect(screen.queryByLabelText('API Key')).not.toBeInTheDocument();
++
++ await user.click(screen.getByRole('button', { name: '保存配置' }));
++
++ await waitFor(() => expect(service.saveConfig).toHaveBeenCalled());
++ expect(modelService.updateCodexProvider).not.toHaveBeenCalled();
++ expect(vi.mocked(service.saveConfig).mock.calls[0]?.[0].llm.source).toBe('codex');
++ });
++
++ it('keeps custom model configuration available when local Codex is unavailable', async () => {
++ const user = userEvent.setup();
++ const service = createService([], runtimeCapabilities('darwin', 'arm64'), 'codex');
++ const modelService = createModelService();
++ vi.mocked(modelService.getCodexProvider).mockRejectedValue(new Error('Codex unavailable'));
++ render(
++ <CreatorServicesSettingsView connected service={service} modelService={modelService} />
++ );
++
++ expect(await screen.findByText('未检测到可用的本机 Codex Runtime')).toBeInTheDocument();
++ expect(screen.getByRole('button', { name: '保存配置' })).toBeDisabled();
++
++ await user.click(screen.getByRole('button', { name: '自定义模型服务' }));
++
++ expect(screen.getByLabelText('Base URL')).toBeInTheDocument();
++ expect(screen.getByLabelText('API Key')).toBeInTheDocument();
++ expect(screen.getByRole('button', { name: '保存配置' })).toBeEnabled();
++ });
++
++ it('edits the custom model service used by text tasks', async () => {
const user = userEvent.setup();
const service = createService(['llm.apiKey']);
const modelService = createModelService();
@@@ -32,7 -32,7 +73,6 @@@
expect(screen.getByLabelText('模型')).toHaveValue('gpt-shared');
expect(screen.getByLabelText('API Key')).toHaveAttribute('type', 'password');
expect(screen.getByLabelText('API Key')).toHaveAttribute('placeholder', '已配置,留空则保持');
-- expect(screen.getByText('Agent 可用')).toBeInTheDocument();
expect(screen.getByText('文本任务可用')).toBeInTheDocument();
await user.clear(screen.getByLabelText('模型'));
@@@ -40,17 -40,17 +80,13 @@@
await user.type(screen.getByLabelText('API Key'), 'sk-unified');
await user.click(screen.getByRole('button', { name: '保存配置' }));
-- await waitFor(() => expect(modelService.updateCodexProvider).toHaveBeenCalledWith({
-- baseUrl: 'https://gateway.example.test/v1',
-- model: 'gpt-unified',
-- apiKey: 'sk-unified'
-- }));
await waitFor(() => expect(service.saveConfig).toHaveBeenCalled());
++ expect(modelService.updateCodexProvider).not.toHaveBeenCalled();
expect(vi.mocked(service.saveConfig).mock.calls[0]?.[0].llm).toMatchObject({
baseUrl: 'https://gateway.example.test/v1',
-- apiKey: '',
++ apiKey: 'sk-unified',
model: 'gpt-unified',
-- source: 'codex'
++ source: 'custom'
});
expect(screen.getByText('配置已安全保存')).toBeInTheDocument();
});
@@@ -84,15 -84,15 +120,15 @@@
it('shows the failing save stage and Runtime error message', async () => {
const user = userEvent.setup();
-- const modelService = createModelService();
-- vi.mocked(modelService.updateCodexProvider).mockRejectedValue(
++ const service = createService();
++ vi.mocked(service.saveConfig).mockRejectedValue(
new Error('Base URL 必须是有效的 HTTP 或 HTTPS 地址')
);
render(
<CreatorServicesSettingsView
connected
-- service={createService()}
-- modelService={modelService}
++ service={service}
++ modelService={createModelService()}
/>
);
@@@ -100,9 -100,9 +136,8 @@@
await user.click(screen.getByRole('button', { name: '保存配置' }));
expect(await screen.findByText(
-- '模型服务保存失败:Base URL 必须是有效的 HTTP 或 HTTPS 地址'
++ '创作服务保存失败:Base URL 必须是有效的 HTTP 或 HTTPS 地址'
)).toBeInTheDocument();
-- expect(screen.getByLabelText('Base URL')).toHaveAttribute('aria-invalid', 'true');
});
it('shows configured credentials without loading their secret values', async () => {
@@@ -122,11 -122,11 +157,12 @@@
it('applies an LLM provider preset and model suggestions', async () => {
const user = userEvent.setup();
++ const service = createService();
const modelService = createModelService();
render(
<CreatorServicesSettingsView
connected
-- service={createService()}
++ service={service}
modelService={modelService}
/>
);
@@@ -139,10 -139,10 +175,8 @@@
expect(screen.queryByRole('option', { name: 'MiniMax-M2.7' })).not.toBeInTheDocument();
await user.click(screen.getByRole('button', { name: '保存配置' }));
-- await waitFor(() => expect(modelService.updateCodexProvider).toHaveBeenCalledWith({
-- baseUrl: 'https://api.deepseek.com',
-- model: 'deepseek-v4-pro'
-- }));
++ await waitFor(() => expect(service.saveConfig).toHaveBeenCalled());
++ expect(modelService.updateCodexProvider).not.toHaveBeenCalled();
});
it('does not report a custom provider ready from an unrelated API key login', async () => {
@@@ -154,8 -154,8 +188,7 @@@
/>
);
-- expect(await screen.findByText('Agent 尚未配置')).toBeInTheDocument();
-- expect(screen.getByText('文本任务需要 API Key')).toBeInTheDocument();
++ expect(await screen.findByText('文本任务需要 API Key')).toBeInTheDocument();
});
it('defaults OpenAI to GPT-5.6 and keeps it in the Runtime model list', async () => {
@@@ -384,7 -368,7 +417,10 @@@
await screen.findByRole('tabpanel');
await user.click(screen.getByRole('tab', { name: '图像生成' }));
-- expect(screen.getByRole('combobox', { name: '服务商' })).toHaveTextContent('GPT Image');
++ expect(screen.getByRole('combobox', { name: '服务商' })).toHaveTextContent('本机 Codex 生图');
++ expect(screen.queryByLabelText('模型')).not.toBeInTheDocument();
++ await user.click(screen.getByRole('combobox', { name: '服务商' }));
++ await user.click(screen.getByRole('option', { name: 'GPT Image' }));
expect(screen.getByLabelText('模型')).toHaveValue('gpt-image-1');
await user.click(screen.getByRole('combobox', { name: '服务商' }));
await user.click(screen.getByRole('option', { name: '可灵' }));
@@@ -401,6 -385,29 +437,25 @@@
expect(screen.getByLabelText('默认模型')).toHaveValue('veo-3.1-generate-preview');
});
- it('exposes Codex subscription images without API credential controls', async () => {
++ it('uses local Codex image generation by default without configuration fields', async () => {
+ const user = userEvent.setup();
+ render(
+ <CreatorServicesSettingsView
+ connected
+ service={createService()}
+ modelService={createModelService()}
+ />
+ );
+ await screen.findByRole('tabpanel');
+
+ await user.click(screen.getByRole('tab', { name: '图像生成' }));
- await user.click(screen.getByRole('combobox', { name: '服务商' }));
- await user.click(screen.getByRole('option', { name: 'Codex (assinatura)' }));
-
- expect(screen.getByText(
- '无需 API Key。运行时会通过已登录的 Codex 订阅生成图像,不会调用付费图像 API。'
- )).toBeInTheDocument();
++ expect(screen.getByRole('combobox', { name: '服务商' }))
++ .toHaveTextContent('本机 Codex 生图');
+ expect(screen.queryByLabelText('API Key')).not.toBeInTheDocument();
+ expect(screen.queryByLabelText('Base URL')).not.toBeInTheDocument();
+ expect(screen.queryByLabelText('模型')).not.toBeInTheDocument();
+ });
+
it('keeps non-model services available when the model provider cannot be read', async () => {
const modelService = createModelService();
vi.mocked(modelService.getCodexProvider).mockRejectedValue(
@@@ -431,11 -438,11 +486,13 @@@
function createService(
configuredCredentials: CreatorServicesCredentialField[] = [],
-- capabilities: CreatorServicesCapabilitiesResponse = runtimeCapabilities('darwin', 'arm64')
++ capabilities: CreatorServicesCapabilitiesResponse = runtimeCapabilities('darwin', 'arm64'),
++ source: 'codex' | 'custom' = 'custom'
): CreatorServicesSettingsService {
const config = createDefaultCreatorServicesConfig();
config.llm.baseUrl = 'https://gateway.example.test/v1';
config.llm.model = 'gpt-shared';
++ config.llm.source = source;
return {
getCapabilities: vi.fn(async () => structuredClone(capabilities)),
getConfig: vi.fn(async () => ({ config: structuredClone(config), configuredCredentials })),
diff --cc apps/web/src/features/settings/CreatorServicesSettingsView.tsx
index 3cc7eb90,0e5c7d99..ede9b0b4
--- a/apps/web/src/features/settings/CreatorServicesSettingsView.tsx
+++ b/apps/web/src/features/settings/CreatorServicesSettingsView.tsx
@@@ -48,6 -46,6 +48,7 @@@ type ModelSettingsService = Pick<Connec
getCodexModels?: ConnectionService['getCodexModels'];
};
type ModelFieldErrors = Partial<Record<'baseUrl' | 'apiKey' | 'model' | 'proxy', string>>;
++type TextModelMode = 'codex' | 'custom';
export function CreatorServicesSettingsView(props: {
connected: boolean;
@@@ -63,6 -61,6 +64,7 @@@
const [config, setConfig] = useState<CreatorServicesConfig>();
const [capabilities, setCapabilities] = useState<CreatorServicesCapabilitiesResponse>();
const [modelProvider, setModelProvider] = useState<CodexProviderConfig>();
++ const [textModelMode, setTextModelMode] = useState<TextModelMode>('codex');
const [modelProviderId, setModelProviderId] = useState('custom');
const [runtimeModelIds, setRuntimeModelIds] = useState<string[]>([]);
const [modelBaseUrl, setModelBaseUrl] = useState('');
@@@ -117,6 -115,6 +119,7 @@@
? modelsResult.value.models.map(model => model.model)
: []);
setConfig(response.config);
++ setTextModelMode(response.config.llm.source);
setCapabilities(capabilitiesResult.value);
setConfiguredCredentials(new Set(response.configuredCredentials));
setSavedTranscriptionSelection(transcriptionSelection(response.config));
@@@ -198,7 -196,7 +201,9 @@@
if (!confirmed) return;
}
if (activeSection === 'text') {
-- const fieldErrors = validateModelFields(modelBaseUrl, modelName, modelApiKey, config.proxy, l);
++ const fieldErrors = textModelMode === 'custom'
++ ? validateModelFields(modelBaseUrl, modelName, modelApiKey, config.proxy, l)
++ : validateModelFields('', 'codex', '', config.proxy, l);
setModelFieldErrors(fieldErrors);
if (Object.keys(fieldErrors).length > 0) {
setError(l(
@@@ -211,32 -209,32 +216,21 @@@
setSaving(true);
setError(undefined);
setNotice(undefined);
-- let savingStage: 'model' | 'services' = 'services';
try {
let nextConfig = structuredClone(config);
if (activeSection === 'text') {
-- savingStage = 'model';
-- if (props.modelService === null || props.modelService === undefined || modelProvider === undefined) {
-- throw new Error('Model provider configuration is unavailable');
++ if (textModelMode === 'codex') {
++ nextConfig.llm = { ...nextConfig.llm, apiKey: '', source: 'codex' };
++ } else {
++ nextConfig.llm = {
++ ...nextConfig.llm,
++ baseUrl: modelBaseUrl,
++ apiKey: modelApiKey,
++ model: modelName,
++ source: 'custom'
++ };
}
-- const provider = await props.modelService.updateCodexProvider({
-- baseUrl: modelBaseUrl,
-- model: modelName,
-- ...(modelApiKey.trim().length === 0 ? {} : { apiKey: modelApiKey })
-- });
-- setModelProvider(provider);
-- setModelBaseUrl(provider.baseUrl);
-- setModelName(provider.model);
-- setModelApiKey('');
-- nextConfig.llm = {
-- ...nextConfig.llm,
-- baseUrl: provider.baseUrl,
-- apiKey: '',
-- model: provider.model,
-- source: 'codex'
-- };
}
-- savingStage = 'services';
const response = await props.service.saveConfig(nextConfig);
setConfig(response.config);
setConfiguredCredentials(new Set(response.configuredCredentials));
@@@ -244,13 -242,13 +238,7 @@@
setNotice(l('配置已安全保存', 'Settings saved securely'));
} catch (cause) {
const message = readableSaveError(cause, l);
-- const field = modelFieldFromError(message);
-- if (activeSection === 'text' && savingStage === 'model' && field !== undefined) {
-- setModelFieldErrors({ [field]: message });
-- }
-- setError(savingStage === 'model'
-- ? l(`模型服务保存失败:${message}`, `Could not save model provider: ${message}`)
-- : l(`创作服务保存失败:${message}`, `Could not save creator services: ${message}`));
++ setError(l(`创作服务保存失败:${message}`, `Could not save creator services: ${message}`));
} finally {
setSaving(false);
}
@@@ -348,6 -346,6 +336,8 @@@
update={updateConfig}
configuredCredentials={configuredCredentials}
provider={modelProvider}
++ mode={textModelMode}
++ onModeChange={setTextModelMode}
baseUrl={modelBaseUrl}
model={modelName}
apiKey={modelApiKey}
@@@ -420,6 -418,6 +410,7 @@@
saving
|| (
activeSection === 'text'
++ && textModelMode === 'codex'
&& modelProvider === undefined
)
}
@@@ -440,6 -438,6 +431,8 @@@
function TextModelSettings(props: SettingsGroupProps & {
provider?: CodexProviderConfig;
++ mode: TextModelMode;
++ onModeChange(value: TextModelMode): void;
baseUrl: string;
model: string;
apiKey: string;
@@@ -454,14 -452,14 +447,14 @@@
const legacyApiKeyConfigured = props.config.llm.source === 'custom'
&& props.configuredCredentials.has('llm.apiKey');
const providerApiKeyConfigured = props.provider?.apiKeyConfigured === true;
-- const apiKeyConfigured = providerApiKeyConfigured || legacyApiKeyConfigured;
-- const agentAvailable = props.provider?.baseUrl
-- ? providerApiKeyConfigured
-- : props.provider?.authentication !== 'none' || providerApiKeyConfigured;
-- const textTasksAvailable = apiKeyConfigured;
-- const AgentStatusIcon = agentAvailable ? Check : CircleAlert;
++ const codexAvailable = props.provider !== undefined
++ && (props.provider.authentication === 'chatgpt' || providerApiKeyConfigured);
++ const textTasksAvailable = props.mode === 'codex'
++ ? codexAvailable
++ : legacyApiKeyConfigured || props.apiKey.trim().length > 0;
++ const selectedModeAvailable = props.mode === 'codex' ? codexAvailable : textTasksAvailable;
const TextTaskStatusIcon = textTasksAvailable ? Check : CircleAlert;
-- const modelCredentials = apiKeyConfigured
++ const modelCredentials = legacyApiKeyConfigured
? new Set<CreatorServicesCredentialField>(['llm.apiKey'])
: new Set<CreatorServicesCredentialField>();
return (
@@@ -469,19 -467,19 +462,35 @@@
<SettingsFieldset
title={l('模型服务', 'Model provider')}
description={l(
-- 'OpenCreator Agent 与翻译、脚本处理等文本任务共用这一套 OpenAI 兼容配置。',
-- 'OpenCreator Agent and text tasks such as translation and script processing share this OpenAI-compatible configuration.'
++ '选择使用本机 Codex,或继续配置独立的 OpenAI 兼容模型服务。',
++ 'Use the local Codex runtime or configure a separate OpenAI-compatible model service.'
)}
>
-- <label className="creator-services-field">
++ <div className="creator-services-segmented is-wide" role="group" aria-label={l('文本任务运行方式', 'Text task execution mode')}>
++ <button
++ type="button"
++ aria-pressed={props.mode === 'codex'}
++ onClick={() => props.onModeChange('codex')}
++ >
++ {l('Codex 本机运行时', 'Local Codex runtime')}
++ </button>
++ <button
++ type="button"
++ aria-pressed={props.mode === 'custom'}
++ onClick={() => props.onModeChange('custom')}
++ >
++ {l('自定义模型服务', 'Custom model service')}
++ </button>
++ </div>
++ {props.mode === 'custom' ? <label className="creator-services-field is-wide">
<span>{l('供应商', 'Provider')}</span>
<select value={props.providerId} onChange={event => props.onProviderIdChange(event.target.value)}>
{Object.values(creatorProviderCatalogById.llm).map(provider => (
<option key={provider.id} value={provider.id}>{provider.label}</option>
))}
</select>
-- </label>
-- <OpenAiFields
++ </label> : null}
++ {props.mode === 'custom' ? <OpenAiFields
id="llm"
credential="llm.apiKey"
configuredCredentials={modelCredentials}
@@@ -496,29 -494,29 +505,25 @@@
: creatorProviderCatalogById.llm[props.providerId]?.models.map(model => model.id)}
errors={props.fieldErrors}
onChange={props.onProviderChange}
-- />
++ /> : (
++ <p className="creator-services-runtime-note">
++ {props.provider === undefined
++ ? l('未检测到可用的本机 Codex Runtime', 'No local Codex runtime was detected')
++ : props.provider.authentication === 'chatgpt'
++ ? l('已连接本机 Codex · ChatGPT 登录', 'Local Codex connected · ChatGPT sign-in')
++ : l(`已连接本机 Codex · ${props.provider.model || 'Runtime'}`, `Local Codex connected · ${props.provider.model || 'Runtime'}`)}
++ </p>
++ )}
<div className="creator-services-model-status is-wide" role="status">
-- <span className={agentAvailable ? '' : 'is-warning'}>
-- <AgentStatusIcon size={15} aria-hidden="true" />
-- {agentAvailable
-- ? l('Agent 可用', 'Agent ready')
-- : l('Agent 尚未配置', 'Agent not configured')}
-- </span>
-- <span className={textTasksAvailable ? '' : 'is-warning'}>
++ <span className={selectedModeAvailable ? '' : 'is-warning'}>
<TextTaskStatusIcon size={15} aria-hidden="true" />
{textTasksAvailable
? l('文本任务可用', 'Text tasks ready')
-- : l('文本任务需要 API Key', 'Text tasks require an API key')}
++ : props.mode === 'codex'
++ ? l('本机 Codex 尚未配置', 'Local Codex is not configured')
++ : l('文本任务需要 API Key', 'Text tasks require an API key')}
</span>
</div>
-- {props.provider?.authentication === 'chatgpt' && !textTasksAvailable ? (
-- <p className="creator-services-inline-note is-warning">
-- {l(
-- 'ChatGPT 登录可用于 Agent,但视频翻译等文本任务通过兼容 API 调用,仍需填写 API Key。',
-- 'ChatGPT sign-in can power the Agent, but text tasks such as video translation use the compatible API and still require an API key.'
-- )}
-- </p>
-- ) : null}
{props.error === undefined ? null : (
<p className="creator-services-inline-note is-warning" role="alert">
{props.error}
@@@ -600,15 -598,15 +605,6 @@@ function readableSaveError
return l('本地 Runtime 未返回具体原因', 'The local Runtime did not return a reason');
}
--function modelFieldFromError(message: string): keyof ModelFieldErrors | undefined {
-- const normalized = message.toLowerCase();
-- if (normalized.includes('base url') || normalized.includes('baseurl')) return 'baseUrl';
-- if (normalized.includes('api key') || normalized.includes('apikey')) return 'apiKey';
-- if (normalized.includes('proxy') || normalized.includes('代理')) return 'proxy';
-- if (normalized.includes('model') || normalized.includes('模型')) return 'model';
-- return undefined;
--}
--
function TranscriptionSettings(props: SettingsGroupProps & {
capabilities: CreatorServicesCapabilitiesResponse;
}) {
@@@ -949,13 -907,13 +945,14 @@@ function ImageSettings(props: SettingsG
return (
<SettingsFieldset
title={l('图像生成', 'Image generation')}
- description={l('配置 GPT Image、即梦、可灵或 Gemini 图像服务。', 'Configure GPT Image, Jimeng, Kling, or Gemini image generation.')}
- description={l('配置 GPT Image、即梦、可灵、Gemini 或本地 Codex 订阅图像生成。', 'Configure GPT Image, Jimeng, Kling, Gemini, or local Codex subscription image generation.')}
++ description={l('选择本机 Codex 生图,或配置其他图像生成服务。', 'Use local Codex image generation or configure another image provider.')}
>
<SelectField
id="image-provider"
label={l('服务商', 'Provider')}
value={provider}
options={[
++ ['codex-native', l('本机 Codex 生图', 'Local Codex image generation')],
['openai', 'GPT Image'],
['jimeng', l('即梦', 'Jimeng')],
['kling', l('可灵', 'Kling')],
diff --cc apps/web/src/features/settings/creator-services-settings.css
index 88f8a1c7,728a3ac8..ca594a15
--- a/apps/web/src/features/settings/creator-services-settings.css
+++ b/apps/web/src/features/settings/creator-services-settings.css
@@@ -138,6 -142,6 +138,7 @@@
}
.creator-services-field.is-wide,
++.creator-services-segmented.is-wide,
.creator-services-subheading,
.creator-services-tts-voice,
.creator-services-toggle,
@@@ -509,6 -513,6 +510,7 @@@
.creator-services-tabs { grid-template-columns: repeat(2, minmax(0, 1fr)); }
.creator-services-grid { grid-template-columns: minmax(0, 1fr); }
.creator-services-field.is-wide,
++ .creator-services-segmented.is-wide,
.creator-services-subheading,
.creator-services-tts-voice,
.creator-services-toggle,
diff --cc "docs/operations/real-person-sticker-templates-\347\234\237\344\272\272\350\264\264\347\272\270\346\250\241\346\235\277\350\257\264\346\230\216.md"
index 041a3a4b,041a3a4b..75e5432c
--- "a/docs/operations/real-person-sticker-templates-\347\234\237\344\272\272\350\264\264\347\272\270\346\250\241\346\235\277\350\257\264\346\230\216.md"
+++ "b/docs/operations/real-person-sticker-templates-\347\234\237\344\272\272\350\264\264\347\272\270\346\250\241\346\235\277\350\257\264\346\230\216.md"
@@@ -19,7 -19,7 +19,7 @@@
先生成图片,再将选定图片上传为视频参考图;两个预设是独立任务,不声称自动串联。示例图不预绑定到用户任务。
--图片预设使用 `openai`(GPT Image 接口),需用户自行在 AI 服务中配置实际支持参考图编辑的服务与模型;不更改用户凭证。图片默认尺寸为当前运行时支持的 1024×1536(2:3),而教程示例是 3:4,不声称尺寸完全相同。
++图片预设继承 AI 服务中当前选择的图片 Provider,并要求该 Provider 支持参考图;不更改用户凭证。图片默认尺寸为当前运行时支持的 1024×1536(2:3),而教程示例是 3:4,不声称尺寸完全相同。
视频预设沿用用户的视频服务和模型配置。4 秒是教程原参数,也是本地预设默认值,但并非所有服务、模型都支持;如所选服务不支持,须改为其实际支持时长,提示词中的时长也相应调整。Seedance 图生视频跟随参考图画幅,其他服务以实际实现为准。背景完全冻结、人物身份保真是生成要求,不是确定性保证。
diff --cc "docs/operations/retro-illustration-templates-\345\244\215\345\217\244\346\217\222\347\224\273\346\250\241\346\235\277\350\257\264\346\230\216.md"
index 06b0ce46,06b0ce46..28370ede
--- "a/docs/operations/retro-illustration-templates-\345\244\215\345\217\244\346\217\222\347\224\273\346\250\241\346\235\277\350\257\264\346\230\216.md"
+++ "b/docs/operations/retro-illustration-templates-\345\244\215\345\217\244\346\217\222\347\224\273\346\250\241\346\235\277\350\257\264\346\230\216.md"
@@@ -18,7 -18,7 +18,7 @@@
转绘默认方形、高清、一次一张;排版草稿默认竖向图像;微动效默认竖向视频、5 秒。图片 Runtime(运行时)支持 1:1、3:2、2:3,不支持教程画面的 3:4,因此预设尺寸只是本地适配值,不是原教程参数。Seedance 图生视频会跟随参考图画幅,其他视频服务按其实现处理尺寸。
--转绘预设绑定 `openai`(GPT Image 接口),需在 AI 服务设置中配置实际支持参考图编辑的服务与模型;不自动安装模型、不改写凭证。不将教程中的示例图片或任务编号绑定到用户任务。上传原照片后再生成;空输入或没有参考图的文生图不属于本教程的照片转绘验收。
++转绘预设继承 AI 服务中当前选择的图片 Provider,并要求该 Provider 支持参考图;不自动安装模型、不改写凭证。不将教程中的示例图片或任务编号绑定到用户任务。上传原照片后再生成;空输入或没有参考图的文生图不属于本教程的照片转绘验收。
微动效沿用用户视频服务和模型配置,不声称指定服务与原教程相同。需上传成品插画或海报;文字稳定、主体不变形及循环衔接是生成约束,不是确定性保证。
diff --cc packages/protocol/src/creator-provider-catalog.test.ts
index b2387b9a,f8bd8259..5d6a2cc3
--- a/packages/protocol/src/creator-provider-catalog.test.ts
+++ b/packages/protocol/src/creator-provider-catalog.test.ts
@@@ -32,7 -32,19 +32,19 @@@ describe('creator provider catalog', (
});
it('marks only implemented providers as supported', () => {
- expect(creatorProviderCatalog.every(entry => entry.status === 'supported')).toBe(true);
+ expect(creatorProviderCatalog
+ .filter(entry => entry.id !== 'codex-native')
+ .every(entry => entry.status === 'supported')).toBe(true);
expect(creatorProviderCatalogById.image.gemini?.status).toBe('supported');
});
+
+ it('describes Codex native image generation as credential-free and experimental', () => {
+ expect(creatorProviderCatalogById.image['codex-native']).toMatchObject({
- label: 'Codex (assinatura)',
++ label: 'Local Codex image generation',
+ protocol: 'local',
+ credentials: [],
- capabilities: ['text-to-image'],
++ capabilities: ['text-to-image', 'image-edit', 'reference-image'],
+ status: 'experimental'
+ });
+ });
});
diff --cc packages/protocol/src/creator-provider-catalog.ts
index 17ccd862,900055b3..9352a99f
--- a/packages/protocol/src/creator-provider-catalog.ts
+++ b/packages/protocol/src/creator-provider-catalog.ts
@@@ -33,6 -33,7 +33,7 @@@ export const creatorProviderCatalog =
entry({ id: 'jimeng', kind: 'image', label: '即梦 / Seedream', protocol: 'openai-compatible', defaultBaseUrl: 'https://ark.cn-beijing.volces.com/api/v3', models: [{ id: 'doubao-seedream-4-0-250828', label: 'Seedream 4.0', recommended: true }], credentials: ['apiKey'], capabilities: ['text-to-image'], status: 'supported' }),
entry({ id: 'kling', kind: 'image', label: '可灵 / Kling', protocol: 'kling', defaultBaseUrl: 'https://api-beijing.klingai.com', models: [{ id: 'kling-v2-1', label: 'Kling v2.1', recommended: true }], credentials: ['accessKey', 'secretKey'], capabilities: ['text-to-image'], status: 'supported' }),
entry({ id: 'gemini', kind: 'image', label: 'Nano Banana / Gemini', protocol: 'gemini', defaultBaseUrl: 'https://generativelanguage.googleapis.com/v1beta', models: [{ id: 'gemini-2.5-flash-image', label: 'Nano Banana', recommended: true }], credentials: ['apiKey'], capabilities: ['text-to-image', 'reference-image'], status: 'supported' }),
- entry({ id: 'codex-native', kind: 'image', label: 'Codex (assinatura)', protocol: 'local', models: [], credentials: [], capabilities: ['text-to-image'], status: 'experimental' }),
++ entry({ id: 'codex-native', kind: 'image', label: 'Local Codex image generation', protocol: 'local', models: [], credentials: [], capabilities: ['text-to-image', 'image-edit', 'reference-image'], status: 'experimental' }),
entry({ id: 'seedance', kind: 'video', label: 'Seedance', protocol: 'openai-compatible', defaultBaseUrl: 'https://ark.cn-beijing.volces.com/api/v3', models: [{ id: 'doubao-seedance-2-5-260628', label: 'Seedance 2.5', recommended: true }], credentials: ['apiKey'], capabilities: ['text-to-video', 'image-to-video'], status: 'supported' }),
entry({ id: 'kling-video', kind: 'video', label: '可灵 / Kling', protocol: 'kling', defaultBaseUrl: 'https://api-beijing.klingai.com', models: [{ id: 'kling-v2-1-master', label: 'Kling v2.1 Master', recommended: true }], credentials: ['accessKey', 'secretKey'], capabilities: ['text-to-video', 'image-to-video'], status: 'supported' }),
entry({ id: 'veo', kind: 'video', label: 'Veo', protocol: 'gemini', defaultBaseUrl: 'https://generativelanguage.googleapis.com/v1beta', models: [{ id: 'veo-3.1-generate-preview', label: 'Veo 3.1', recommended: true }], credentials: ['apiKey'], capabilities: ['text-to-video', 'image-to-video'], status: 'supported' }),
diff --cc packages/protocol/src/creator-services.ts
index c0887c6a,2439ad4b..38e2c80a
--- a/packages/protocol/src/creator-services.ts
+++ b/packages/protocol/src/creator-services.ts
@@@ -123,10 -84,9 +123,10 @@@ export type CreatorServicesConfig =
openai: CreatorTtsProviderConfig;
minimax: CreatorTtsProviderConfig;
aliyun: CreatorTtsProviderConfig;
+ volcengine: VolcengineTtsConfig;
};
image: {
- provider: 'openai' | 'jimeng' | 'kling' | 'gemini';
+ provider: 'openai' | 'jimeng' | 'kling' | 'gemini' | 'codex-native';
openai: OpenAiCompatibleConfig;
jimeng: OpenAiCompatibleConfig;
kling: KlingAiConfig;
@@@ -281,7 -192,7 +282,7 @@@ export function createDefaultCreatorSer
}
},
image: {
-- provider: 'openai',
++ provider: 'codex-native',
openai: {
baseUrl: '',
apiKey: '',
diff --cc packages/protocol/src/creator.ts
index ce2e71fd,ce2e71fd..66303349
--- a/packages/protocol/src/creator.ts
+++ b/packages/protocol/src/creator.ts
@@@ -138,10 -138,10 +138,21 @@@ export type CreatorPresetRef =
version: number;
};
++export const creatorPresetCapabilities = [
++ 'text-to-image',
++ 'reference-image',
++ 'image-edit',
++ 'text-to-video',
++ 'image-to-video',
++ 'speech-generation',
++ 'voice-preview'
++] as const;
++
++export type CreatorPresetCapability = typeof creatorPresetCapabilities[number];
++
export type CreatorPresetRequirements = {
service: 'tts' | 'image' | 'video';
-- provider: string;
-- model?: string;
++ capabilities: CreatorPresetCapability[];
};
export type CreatorPresetHighlight = {
diff --cc template/image-generation/real-person-die-cut-sticker-poster/1/template.json
index 6f938080,6f938080..57bb897c
--- a/template/image-generation/real-person-die-cut-sticker-poster/1/template.json
+++ b/template/image-generation/real-person-die-cut-sticker-poster/1/template.json
@@@ -32,10 -32,10 +32,6 @@@
"真人贴纸",
"reference-template"
],
-- "requirements": {
-- "service": "image",
-- "provider": "openai"
-- },
"defaults": {
"prompt": "",
"size": "1024x1536",
diff --cc template/image-generation/retro-halftone-illustration/1/template.json
index fa08482c,fa08482c..7ee3eef2
--- a/template/image-generation/retro-halftone-illustration/1/template.json
+++ b/template/image-generation/retro-halftone-illustration/1/template.json
@@@ -32,10 -32,10 +32,6 @@@
"reference-image",
"reference-template"
],
-- "requirements": {
-- "service": "image",
-- "provider": "openai"
-- },
"defaults": {
"prompt": "",
"size": "1024x1024",
diff --cc template/image-generation/retro-scrapbook-poster/1/template.json
index 3f8de053,3f8de053..a3de371d
--- a/template/image-generation/retro-scrapbook-poster/1/template.json
+++ b/template/image-generation/retro-scrapbook-poster/1/template.json
@@@ -31,10 -31,10 +31,6 @@@
"multi-reference",
"reference-template"
],
-- "requirements": {
-- "service": "image",
-- "provider": "openai"
-- },
"defaults": {
"prompt": "",
"size": "1024x1536",