Flutter / Dart

1. Set up your project

Start from sdk/flutter in the Cloud repository. These commands use the local source package, not a registry release.

dart pub get
dart test
# Server example only:
dart run example/main.dart

2. Prepare authentication

Server examples read MULTIVIBE_BASE_URL and MULTIVIBE_TOKEN from the environment. Use an origin without /v1. Never ship a project key in a browser or mobile bundle.

For client applications, use a user-authorized OAuth access-token provider and OS-secure storage. Browser refresh and exchange require a backend. Backendless publisher-funded sessions are not implemented.

3. Make your first request

This example discovers models. Mobile snippets belong in your authenticated application; they are not standalone app projects.

// Dart server example. For Flutter inject an authenticated short-lived session callback.
import 'dart:io';
import 'package:multivibe/multivibe.dart';
Future<void> main() async {
 final client=MultiVibe(Platform.environment['MULTIVIBE_BASE_URL']!,token:()=>Platform.environment['MULTIVIBE_TOKEN']!);
 try{await client.models();stdout.writeln('Model catalog request succeeded (response not logged).');}finally{client.close();}
}

Next steps

Choose a compatible model from the catalog before inference. Handle expired access, insufficient scope and unavailable models separately. Never retry a billable inference blindly after a timeout or partial stream.

Local execution and fallback policy →