HeyPuter/puter · error · HttpError

unauthorized

unauthorized

Error message

Authentication required

What it means

Error "Authentication required" thrown in HeyPuter/puter.

Source

Thrown at src/backend/drivers/ai-video/VideoGenerationDriver.ts:124

                    (model as { costs?: Record<string, number> }).costs ?? {},
                )) {
                    if (typeof raw !== 'number' || !Number.isFinite(raw))
                        continue;
                    out.push({
                        usageType: `${model.provider}:${model.id}:${costKey}`,
                        costValue: raw,
                        source: `driver:aiVideo/${model.provider}`,
                    });
                }
            }
        }
        return out;
    }

    async generate(args: IGenerateVideoParams) {
        const actor = Context.get('actor') as Actor | undefined;
        if (!actor)
            throw new HttpError(401, 'Authentication required', {
                legacyCode: 'unauthorized',
            });

        const puterOutputPath = args.puter_output_path;
        delete args.puter_output_path;

        // Validate the output path early — before spending credits.
        let resolvedOutputPath: string | undefined;
        if (puterOutputPath) {
            const username = actor.user?.username;
            const userId = actor.user?.id;
            if (!userId || !username) {
                throw new HttpError(
                    400,
                    'User ID required for puter_output_path',
                    { legacyCode: 'bad_request' },
                );
            }

View on GitHub (pinned to 908ec23eda)

Solutions

1. Authenticate the request with a valid user or app token.
2. Ensure the caller is signed in before invoking the video generation driver.

When it happens

Trigger: Thrown at src/backend/drivers/ai-video/VideoGenerationDriver.ts:124 when the library encounters an invalid state.

Common situations: See trigger scenarios.

Understand the failure class

• Authentication and authorization failures — expired tokens, bad credentials, and missing scopes.

AI-assisted analysis of HeyPuter/puter@908ec23eda (2026-08-12). Data as JSON: /api/errors/8d474dfe0ddbf67f. Report an issue: GitHub.