create_payment
Create a Lightning invoice to pay for one AI service call. Returns payment ID and invoice details for instant micropayment.
Instructions
Create a Lightning invoice to pay for one AI service call. Returns JSON: { paymentId, invoice (BOLT11), amount (sats), expiresAt }. Each payment covers exactly one tool call — call this once per operation. Typical flow: list_models → create_payment → check_payment_status → call tool. The invoice expires in 10 minutes. Call list_models first to discover modelId values. modelId is optional — omit it to use the default (best) model. Some tools require extra params at payment time because pricing depends on them: generate_text requires prompt (price = f(char count)); send_sms, place_call, ai_call require phoneNumber; generate_video requires duration, mode, generate_audio; animate_image requires duration (100 sats/sec); edit_image requires resolution (1K=200, 2K=300, 4K=450 sats). If required params are missing, the response includes an error with the missing field names.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| toolName | Yes | Tool name to pay for (e.g., 'generate_text', 'generate_image', 'generate_video', 'send_sms', 'place_call') | |
| modelId | No | Optional. AI model ID from list_models. Omit for default (best) model. | |
| prompt | No | Required for generate_text: the exact prompt (price calculated from char count, locked to payment) | |
| systemPrompt | No | For generate_text: include if using a custom system prompt (affects price) | |
| fileContext | No | For generate_text: include extracted file text if attaching a file (affects price) | |
| phoneNumber | No | Required for send_sms and place_call: phone in E.164 format (e.g., +14155550100) | |
| message | No | Required for send_sms: message text (max 120 chars) | |
| durationMinutes | No | Required for place_call with audioUrl: duration in minutes (1-30) | |
| duration | No | Required for generate_video: duration in seconds (3-15) | |
| mode | No | For generate_video: quality mode (default: 'pro'). standard: 300 sats/sec (no audio), 400 sats/sec (audio). pro: 450 sats/sec (no audio), 550 sats/sec (audio). | |
| generate_audio | No | For generate_video: include AI audio track (default: false). Adds 100 sats/sec. | |
| resolution | No | For edit_image: output resolution. 1K=200 sats, 2K=300 sats, 4K=450 sats. Default: 1K. |