PHPackages                             useflipp/client - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. useflipp/client

ActiveLibrary[API Development](/categories/api)

useflipp/client
===============

API client for Flipp

v1.0.0(5y ago)1845MITPHPPHP >=7.4

Since Mar 22Pushed 5y ago2 watchersCompare

[ Source](https://github.com/useflipp/client)[ Packagist](https://packagist.org/packages/useflipp/client)[ RSS](/packages/useflipp-client/feed)WikiDiscussions master Synced 1w ago

READMEChangelogDependencies (4)Versions (2)Used By (0)

[![Flipp social media card ](/art/cover.png)](/art/cover.png)

Flipp – API for image generation
================================

[](#flipp--api-for-image-generation)

Flipp is a service that lets you create unique preview images. Generate social media visuals through REST API, or using Signed URLs.

The package is an official wrapper for Flipp API. To start using it, you'll need to [create your free](https://useflipp.com/register) account and get the [API key](https://useflipp.com/settings/profile/api).

Installation
------------

[](#installation)

```
composer require useflipp/client
```

Usage
-----

[](#usage)

### Generate image synchronously

[](#generate-image-synchronously)

Here's a quick example of how to generate an image synchronously using API.

```
use Flipp\Client\Client as FlippClient;

FlippClient::make($apiKey)
  ->setTemplate($templateId)
  ->setField('title', 'Dynamic Value')
  ->getImage(); // returns generated image URL
```

Please note that the image generation process may take up to 2-3s depending on the template complexity and connection quality.

### Signed URLs

[](#signed-urls)

In case if you don't want to perform requests synchronously, you can generate signed URLs with encoded parameters. This doesn't require the API call, and the images will be generated during the first HTTP call (page visit).

```
use Flipp\Client\Client as FlippClient;

FlippClient::make($apiKey)
  ->setTemplate($templateId)
  ->setField('title', 'Dynamic Value')
  ->getSignedUrl(); // returns signed URL
```

### Dynamic values and styles

[](#dynamic-values-and-styles)

You can set dynamic fields values as well as their styles. This option is only available for API calls.

```
FlippClient::make($apiKey)
  ->setTemplate($templateId)
  ->setField('title', 'Dynamic Value', [
    'color' => '#ff00ff',
  ])
  ->setField('square', null, [
    'backgroundColor' => '#aa3f3f'
  ]);
```

### Fallback URLs

[](#fallback-urls)

With Flipp, you can also create Fallback URLs with social media previews for the links you can't integrate Flipp directly.

```
FlippClient::make($apiKey)
  ->setTemplate($templateId)
  ->setField('title', 'Meta Title') // optional
  ->setField('description', 'Meta Description') // optional
  ->getLink($url); // returns short link
```

This method returns a short link that might be shared on social media. You can specify custom title and description which will be used in the template as well as for the metadata for the generated page. If you won't provide the data, those values will be fetched from the provided external URL.

###  Health Score

26

—

LowBetter than 43% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity15

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity52

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

1882d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/80906827?v=4)[Flipp](/maintainers/useflipp)[@useflipp](https://github.com/useflipp)

---

Top Contributors

[![lepikhinb](https://avatars.githubusercontent.com/u/17538801?v=4)](https://github.com/lepikhinb "lepikhinb (4 commits)")

###  Code Quality

TestsPest

### Embed Badge

![Health badge](/badges/useflipp-client/health.svg)

```
[![Health](https://phpackages.com/badges/useflipp-client/health.svg)](https://phpackages.com/packages/useflipp-client)
```

###  Alternatives

[spatie/laravel-query-builder

Easily build Eloquent queries from API requests

4.4k26.9M220](/packages/spatie-laravel-query-builder)[essa/api-tool-kit

set of tools to build an api with laravel

52680.5k](/packages/essa-api-tool-kit)[esign/laravel-conversions-api

A laravel wrapper package around the Facebook Conversions API

69145.4k](/packages/esign-laravel-conversions-api)[aedart/athenaeum

Athenaeum is a mono repository; a collection of various PHP packages

245.2k](/packages/aedart-athenaeum)[surface/laravel-webfinger

A Laravel package to create an ActivityPub webfinger.

113.8k](/packages/surface-laravel-webfinger)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)